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Android Studio 使 用 艺术 


本 书 不 一 定 要 按照 从 头 开始 读 到 尾 ， 选 择 自己 需要 的 部 分 阅读 ， 类 似 于 我 们 Java 的 AP| 文 档 ， 
但 是 API 文 档 更 加 容易 理解 ， 会 有 很 多 的 使 用 技巧 ， 使 用 经 验 在 里 面 。 


每 一 个 操作 都 会 带 实 例 演 示 ， 让 读者 看 到 我 的 操作 步骤 。 


此 书 采用 开源 的 形式 编写 ， 所 以 每 个 Android 都 可 以 参与 ， 而 且 这 个 不 像 某 些 技术 形 书籍 ， 需 
要 功底 才能 表达 出 来 ， 此 书 属于 操作 类 型 的 ， 没 有 什么 高 深 的 理论 ， 只 需要 把 你 使 用 的 方法 
写 出 来 就 可 以 。 


书 中 提 到 的 快捷 键 全 部 都 是 Android Studio 默认 快捷 键 。 
所 有 的 源 文件 都 在 github 上 ， 和 希望 大 伙 一 起 来 做 这 个 有 意思 的 事情 。 
交流 群 : 104848238 
阅读 地 址 : https:VVas.quanke.nameV 
下 载 地 址 : https:VVwww.gitbook.comVbookVdquankeVandroid-studioVdetails 
协作 地 址 : https:VWgithub.comVquankeVandroid-studio 
我 是 全 科 ， 欢 迎 关注 我 的 博客 http:VVquanke.name 
此 书 不 一 定 是 按 顺 序 编写 


现在 正在 编辑 的 章节 


已 经 完成 编辑 的 章节 : 
第 一 章 Android Studio AT] 


第 二 章 新 奸 


Android Studio 使 用 艺术 介绍 


第 五 章 编辑 
第 七 章 导航 
第 八 章 编码 
第 十 章 重 构 
第 十 一 章 - 打 包 构 建 
第 十 二 章 运行 调试 
第 十 四 章 版 本 控制 
第 十 六 章 插件 


附录 快捷 键 


Android Studio 发 布 版 本 


Android Studio 2.2 正式 稳定 版 


https://www.oschina.net/news/77286/android-studio-2-2-stable 
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http: VVwww.oschina.netVnews\/77431\V/android-studio-2-2-new-features 


很 多 做 Android 开 发 的 同学 都 关注 技术 ， 但 我 感觉 对 于 一 个 开发 者 来 说 ， 工 具 的 使 用 非常 重 
要 ， 可 以 提高 编码 速度 ， 可 以 让 更 多 的 时 间 花 在 多 辑 上 ， 或 者 有 更 多 的 时 间 成 长 ， 而 不 是 浪 


费 在 敲 代 码 上 ， 对 于 一 个 管理 者 来 说 更 加 重要 ， 工 具 的 熟练 成 功 直接 影响 开发 效率 ， 所 以 我 
有 编辑 此 书 的 想法 。 


> 
X 


第 一 章 Android Studio 入 门 


本 章 主 要 是 介绍 在 Windows，Linux > Mac 三 个 平台 下 载 安 装 Android Studio ° 


下 载 


官方 下 载 
http://developer.android.com/sdk/index.html 


这 里 提供 三 个 平台 下 载 ， 请 选择 需要 的 下 载 


选择 其 他 平台 


EE EE 


Windows android-studio-bundle-143.3101438-windows.exe 1262 MB 


包 合 Android SOK 《推荐 》 (1324294792 bytes) 
android-studio-ide-143.3101438-windows.exe 259 MB 
无 Android SDK (271696304 bytes) 
android-studio-ide-143.3101438-windows.zip 275 MB 
Æ Android SDK， 无 安装 程序 (289169874 bytes) 
MacOSX android-studio-ide-143.3101438-mac.dmg 273 MB 
(287207166 bytes) 
Linux android-studio-ide-143.3101438-linux.zip 273 MB 
(286664165 bytes) 


请 参阅 Android Studio 发 行 说 明 。 


国内 下 载 


10d319c772b80f3cb0cde952451af8429ea1b68b 


43f84de7e61f37880a126c3d567b7fa6cb90c90e 


8ad212c55c7f4dc7ab490e4b7e77ec48001ae224 


06166759b0elelee91a147dcf5227d897a184277 


8729e6f2f1fa58f04df9f8d1caac2f5be9dfc549 


虽然 官方 的 下 载 是 最 权威 ， 最 新 的 ， 但 是 考虑 国内 的 情况 ， 有 同仁 提供 国内 下 载 。 


http://www.androiddevtools.cn/ 


此 在 下 不 一 定 是 最 新 的 ， 并 且 所 有 的 ， 个 人 建议 还 是 走 官方 渠道 下 载 。 
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Windows 环境 配置 


配置 JDK 


下 载 JDK8 


下 载 地 址 : http:W/www.oracle.comVtechnetworkVjavaVjavaseVdownloadsVjdk8-downloads- 
2133151.html 


Java SE Development Kit 8u101 


You must accept the Oracle Binary Code Si Agreement for Java SE to download this 
software. 
Thank you for accepting the Oracle Binary Code License Agreement for Java SE; you may 
now download this software. 


Product / File Description File Size Download 
Linux ARM 32 Hard Float ABI 77.77 MB  jdk-8u101-linux-arm32-vfp-hfit.tar.gz 
Linux ARM 64 Hard Float ABI 74.72MB — jdk-8u101-linux-arm64-vfp-hfit.tar.gz 
Linux x86 160.28MB = jdk-8u101-linux-i586.rpm 
Linux x86 174.96 MB = jdk-8u101-linux-i586.tar.gz 
Linux x64 158.27 MB = jdk-8u101-linux-x64.rpm 
Linux x64 172.95MB = jdk-8u101-linux-x64.tar.gz 
MacOSX 227.36 MB jdk-8u101-macosx-x64.dmg 
Solaris SPARC 64-bit 139.66 MB = jdk-8u101-solaris-sparcv9.tar.Z 
Solaris SPARC 64-bit 98.96 MB  jdk-8u101-solaris-sparcv9.tar.gz 
Solaris X64 140.33 MB jdk-8u101-solaris-x64.tar.z 
Solaris x64 96.78 MB  jdk-8u101-solaris-x64 tar.gz 
188.32 MB  jdk-8u101-windows-i586.exe 
193.68 MB dk-8u101-windows-x64.exe 








选择 自己 合适 的 平台 ， 下 载 


È: 


JDK 


aA OF 


装 
载 完成 后 双击 安装 ,并 按照 提示 一 步 一 步 直到 完成 安装 。 


建议 默认 安装 


装 时 请 记 住 JDK 的 安装 位 置 ,后 面 我 们 配置 环境 变量 的 时 候 要 用 到 。 
配置 环境 变量 


HUH 一 > 属性 一 > 高 级 系统 设置 一 > 环境 变量 
新 建 系统 变量 JAVA_HOME 一 > 变量 值 为 刚才 安装 的 JDK 的 路 径 
在 系统 变量 path 中 添加 %JAVA_HOME%Nbin 


新 建 系统 变量 cLASS_PATH 一 > 添加 变量 


值 %JAVA_HOME%\Lib\dt . jar; %JAVA_HOME%\1lib\tools. jar; 


注意 : 如 果 crass patH RH path 中 有 其 他 配置 ， 请 在 后 面 增加 ; 再 增加 我 们 需要 的 内 


容 ， 尤 其 是 CLASS_PATH 需要 注意 
到 此 为 止 环 境 变 量 配置 完毕 ,下 面 来 验证 下 是 否 配置 成 功 . 


终端 输入 javac ,如 果 显 示 帮 助 信 息 就 证 明 配 置 正 确 了 . 


c:\Users\yurong>javac 
用 法 : javac <options> <source files> 


能 的 选项 包括 : 
Bs 
& 


Sup al 
-g 生成 所 有 调试 1 
-ginone 不 生成 任何 调试 人 


a 


只 生成 某 些 调试 信息 


-g:{lines, vars, source} 
-nowarn 不 生成 任何 警告 
-verbose 输出 有 关 编 译 器 正在 执行 的 操作 的 消息 
-deprecation 输出 使 用 已 过 时 的 API 的 源 位 置 
查找 用 户 类 文件 和 注释 处 理 程序 的 位 置 


-classpath < 路 径 > 指定 
查找 用 户 类 文件 和 注释 处 理 程序 的 位 置 


ae 
-sourcepath < 路 径 > 指定 查找 输入 源 文 件 的 位 置 


-cp < 路 径 > 4 
-bootclasspath < 路 径 > 履 盖 引导 类 文件 的 位 置 


-extdirs < 目录 > 禾 盖 所 安装 扩展 的 位 置 
-endorseddirs < 目录 > 履 盖 签名 的 标准 路 径 的 位 置 
-processor <classi>[,<class2>,<class3>...] 要 运行 的 注释 处 理 程序 的 名 称 ; BUR 


-proc:{none, only} 控制 是 否 执 行 注释 处 理 和 /或 编译 。 


认 的 搜索 进程 


-processorpath < 路 径 > 指定 查找 注释 处 理 程 序 的 位 置 
-parameters 生成 元 数据 以 用 于 方法 参数 的 反射 


-d < 目录 > 指定 放置 生成 的 类 文件 的 位 置 


-S < 目录 > 指定 放置 生成 的 源 文件 的 位 置 


-h < 目录 > 指定 放置 生成 的 本 机 标 头 文件 的 位 置 
-implicit:{none,class} 指定 是 否 为 隐 式 引用 文件 生成 类 文件 
-encoding < 编码 > 指定 源 文 件 使 用 的 字符 编码 

-source < 发 行 版 > 提供 与 指定 发 行 版 的 源 兼容 性 

-target < 发 行 版 > 生成 特定 VM 版 本 的 类 文件 

-profile < 配置 文件 > 请 确保 使 用 的 API 在 指定 的 配置 文件 中 可 用 
-version 版 本 信息 

-help 输出 标准 选项 的 提要 

-A 关键 字 [= 值 ] 传递 给 注释 处 理 程 序 的 选 

-X 输出 非 标准 选项 的 提要 

-J< 标 记 > 直接 将 < 标记 > 传递 给 运行 时 系统 

-Werror 出 现 警 告 时 终止 编译 


@< 文 件 名 > 从 文件 读 取 选项 和 文件 名 


配置 Android Studio 


下 载 Android Studio 
你 可 以 到 这 里 http:W/developer.android.comVsdkVindex.html 下 载 可 执行 文件 进行 安装 . 


也 可 以 到 这 里 下 载 最 近 的 beta 版 本 http:VVtools.android.comVrecent 试 用 ,beta 版 本 不 用 安装 ,可 
以 多 个 版 本 一 起 使 用 。 


后 动 Android Studio 

下 载 完 成 后 一 > 解压 一 > 进入 到 androidVbin 目 录 一 > 双击 studio64( 如 果 操 作 系统 是 32 位 双 
击 studio) Android Studio ° 

如 果 你 想 导 入 原来 的 设置 ,选中 上 面 的 复 选 框 ,如 果 不 想 就 选 上 下 面 的 复 选 

接 下 来 就 一 步 一 步 按照 提示 往 下 安装 


安装 过 程 中 会 安装 SDK 和 一 些 组 件 ,请 注意 一 下 SDK 的 安装 位 置 ,如 果 你 要 在 终端 直接 使 用 
android 命 令 还 需要 配置 ANDROID 的 环境 变量 . 


Windows 环境 配置 
下 载 完成 后 就 可 以 正常 启动 Android Studio. 


配置 Android 的 环境 变量 


如 果 我 们 想 直 接 使 用 android 提 供 的 一 些 工具 ,就 需要 配置 环境 变量 . 


打开 我 们 下 载 好 的 sdk 目 录 , 看 一 下 里 面 的 目录 结构 ,有 很 多 工具 可 供 我 们 使 用 。 









|d « 新 jn 卷 (C] » Android » sdk » android-sdk-windows » 





组 织 v” 包含 到 库 中 v ”共享 " ”新建 文件 夫 


We 收藏 夫 二。 名称 修改 日 其 





ib 下 载 J add-ons 2016/9/22 19:26 文件 去 
@ =n J| build-tools 2016/9/22 19:49 文件 去 
3] 最 后 访问 的 位 置 J docs 2016/9/22 19:28 Již 
BB Project dJ extras 2016/9/22 19:29 文件 去 
WB Android J licenses 2016/9/22 19:29 文件 去 
d| platforms 2016/9/22 19:31 文件 去 
J platform-tools 2016/9/22 19:29 X 
J samples 2016/9/22 19:33 HEE 
库 J skins 2016/9/22 19:33 SESE 
ca) Git p" sources 2016/9/22 19:34 文件 去 
E wa J system-images 2016/9/22 19:35 文件 去 
图 片 J temp 2016/9/22 19:38 文件 去 
) 文档 J tools 2016/9/22 19:38 文件 夫 
2 音乐 |_| .knownpackages 2016/9/22 20:13 | KNOWNPACKA... 
iğ AVD Manager 2013/11/12 21:36 ”应 用 程序 
本 计算 机 $% SDK Manager 2013/11/12 21:36 ”应 用 程序 
E seine (C) |_| SDK Readme 2011/2/17 8:40 文本 文档 


ce 本 地 磁盘 (D) ~ 
bh 17 个 对 象 


接 下 来 我 们 配置 下 环境 变量 . 


J work 




















右 击 计算 机 一 > 属性 一 > 高 级 系统 设置 一 > 环境 变量 一 > 新 建 系统 变量 ANDROID_HOME 
一 > 变量 值 为 刚才 安装 的 SDK 的 路 径 


接 下 来 在 path 中 添加 Android sdk 和 Android 工 具 的 路 径 
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Windows 环境 配置 


变量 名 w: 
变量 值 V): 


CLASSPATH 
ComSpec 


TAVA HOME 





完成 后 验证 一 下 是 否 


FP_HO_HOST_C... 


NDROID HOME 





C:\Android\sdk\android-sdk-windows 


(we) MW | 


值 

.WTAVA_ HOMESNLib; WTAVA_ HOMENNL... 
C:\Windows\system32\cmd. exe 

HO 

Cr hnAdrnid iawvayidkl A N 45 


ye 
[we | Be | 


配置 的 正确 。 
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: Wsers \yurong>adb 
indroid Debug Bridge version 1.6.32 
evision 69aGd?8bebce—android 


directs adb to listen on all interfaces for ac 
directs command to the only connected USB devic 


returns an error if more than one USB device is 
present. 
-e directs command to the only running emulator. 

returns an error if more than one emulator is r 
inning. 
-s <specific device> directs command to the device or emulator with 
he given 

serial number or qualifier. Overrides ANDROID_S 
RIAL 

environment variable. 
-p <product name or path> simple product name like ’sooner’. or 

a relative/absolute path to a product 

out directory like ’out/target/product/sooner’. 


If -p is not specified. the ANDROID_PRODUCT_OUT 


environment variable is used. which must 

be an absolute path. 

Name of adb server host default: localhost> 

Port of adb server (default: 583'7> 
devices [-1] list all connected devices 

€’-1’ will also list device qualifiers> 
connect <host>[:<port>] connect to a device via TCP/IP 

Port 5555 is used by default if no port number 


s specified. 


只 要 不 报 adb 不 是 内 部 命令 就 是 配置 成 功 啦 。 








Mac OS 环境 配置 


Ac 2. JDK 


17: 下 载 JDK 


下 载 地 址 : JDK8: http:Wwww.oracle.comVtechnetworkVjavaVjavaseVdownloadsVjdk8- 


downloads-2133151.html 


Android Studio2.2 以 后 要 求 必 须 使 用 JDK8 ° 


选择 Mac OS X x64 下 载 : 


Java SE Development Kit 8u101 


You must accept the Oracle Binary Code aum Agreement for Java SE to download this 
softwar 


Thank you for accepting the Oracle Binary Code License Agreement for Java SE; you may 
now download this software. 


Download 
jdk-8u101-linux-arm32-vfp-hfit.tar.gz 
jdk-8u101-linux-arm64-vfp-hfit.tar.gz 
jdk-8u101-linux-i586.rpm 
jdk-8u101-linux-i586.tar.gz 
jdk- out Hou a rpm 

0 





Product File Description File Size 
Linux ARM 32 Hard Float ABI 77.77 MB 
Linux ARM 64 Hard Float ABI 74.72 MB 
Linux x86 160.28 MB 
Linux x86 174.96 MB 
Linux x64 158. = MB 

an 36 MB 
Solaris SPARC 64- bit 98.96 MB 
Solaris x64 140.33 MB 
Solaris x64 96.78 MB 
Windows x86 188.32 MB 
Windows x64 193.68 MB 


VLibraryVJava\VJavaVirtualMachinesV 
如 果 你 安装 了 
: 配置 环境 变量 


先 查看 原来 的 java 版 本 


java -version 


je 20101- -macosx- 84 arg 
U 


jdk- TY TER eee eee 
jdk-8u101-solaris-x64 tar.Z 
jdk-8u101-solaris-x64.tar.gz 
jdk-8u101-windows-i586.exe 
jdk-8u101-windows-x64.exe 


多 个 JDK 版 本 ,这 显示 多 个 。 


再 vim .bash_profile 去 配置 JAVA_HOME 


JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home 
PATH=$JAVA_HOME/bin: $PATH 


CLASSPATH=. : $JAVA_HOME/1lib/dt.jar:$JAVA_HOME/1ib/tools.jar 


export JAVA_HOME 
export CLASSPATH 


export PATH 


保存 后 去 执行 下 面 的 命令 ， 更 新 成 功 


source .bash_profile 


java -version 


e 4 Android Studio 


1. F & Android SDK 
3) http: Vdeveloper.android.comVsdk\V/index.html F # 2% Æ 4) Android SDK 安 装 包 ， 


R TF ak 4  android-sdk_124.4.1-macosx.zip. 


FE BY RG AY AR 


vim ~V.bash_profile 把 下 面 这 些 环境 变量 加 进去 
export ANDROID_HOME=SDK 路 径 


export PATH=$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$PATH 


4. 测 试 一 下 


命令 行 输入 : 


Mac OS 环境 配置 


adb 
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Linux 环境 配置 


安装 JDK 
下 载 JDK8 


下 载 地 址 :http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads- 
2133151.html 


先 增加 执行 权限 : sudo chmod 777 jdk-8u101-linux-x64.bin 


新 建 一 个 文件 夹 : sudo mkdir /opt/java "这 个 是 要 注意 的 ， 因 为 intel 上 对 路 径 的 识别 只 支持 
三 个 路 径 ， 所 有 ， 要 把 JDK 安 装 在 这 三 个 之 一 : /usr/java Or /opt/java OF /usr/lib/jvm 
我 就 在 这 出 了 一 个 问题 


移动 到 要 安装 的 目录 : sudo mv jdk-8u101-linux-x64.bin /opt/java 
sudo /opt/java/jdk-8u101-linux-x64.bin 


这 个 安装 包 的 任务 完成 了 ， 扫 扫 : sudo rm -f /opt/java/jdk-8u101-linux-x64.bin 


配置 JDK 


sudo gedit ~/.bashrc 加 上 : 

#set java environment 

export JAVA\_HOME=\/opt\/java\/jdk1.8.0\_45 

export JRE\_HOME=$JAVA\_HOME\/jre 

export CLASSPATH=$CLASSPATH: $JAVA\_HOME\/1ib:$JRE\_HOME\/1ib 


export PATH=$PATH: $JAVA\_HOME\/bin: $JRE\_HOME\/bin: $JAVA\_HOME\/1ib: $JAVA\_HOME 


sudo gedit /etc/environment 加 上 : 


JAVA_HOME=/opt/java/jdk1.8.0_45 "这 个 是 我 遇 到 第 二 个 问题 ， 不 知道 什么 原因 ， 最 开始 我 
是 在 /etc/profile 配 置 额 上 边 ~/.bashrc 加 的 那 段 ， 就 是 不 行 ， 找 不 到 JAVA_HOME 这 个 项 ， 就 

直接 放 到 这 个 文件 了 一 份 ，ANDROID STUDIO 就 可 以 启动 了 。 之 后 又 吧 /etcVprofile 的 配置 项 
HRS) J ~/.bashrcy ， 我 还 很 小 白 ， 现 在 还 不 知道 是 什么 原因 导致 不 能 读 到 /etc/profile 的 配置 
项 ， 猜 测 可 能 是 没 更 新 环境 变量 ? 有 知道 的 帮忙 回 一 下 。 


配置 Android Studio 


sudo mv android-studio-bundle-130.677228-linux.tgz /opt/ "" // 我 直接 用 的 文档 管理 器 解压 再 挪 
过 去 的 


sudo tar zxvf android-studio-bundle-130.677228-linux.tgz 


可 以 将 目 录 改 成 你 喜欢 的 名 字 : sudo mv /opt/and... /opt/android-studio 


cd /opt/android-studio/bin 
ls 


sudo studio.sh 


版 本 更 新 
启动 时 检测 版 本 更 新 


在 欢迎 界面 一 > 点 击 底部 的 Check for updates now 的 Check. 


手动 检测 版 本 更 新 


REE: 
Mac: Android Studio --> Check for Updates ... 


Windows/Linux: Help 一 > Check for Updates ... 然 后 Android Studio 就 会 开始 检测 是 否 有 更 
新 。 


如 果 已 经 是 最 新 版 本 ,就 会 弹出 提示 。 


如 果 不 是 最 新 版 本 ,就 会 弹出 更 新 提示 ,可 能 是 Android Studio 版 本 更 新 ,也 有 可 能 是 插件 或 SDK 
更 新 。 


配置 更 新 通道 


在 偏好 设置 中 配置 更 新 通道 
操作 步骤 : Preferences 一 > Appearance & Behavior 一 > System Settings 一 > Updates 


在 Updates 界 面 上 显示 了 当前 版 本 的 信息 和 上 次 检查 更 新 的 时 间 ， 我 们 可 以 在 这 里 配置 
Android Studio 和 Android SDK 的 更 新 通道 , 然后 立即 检查 更 新 . 


在 检测 结果 对 话 框 中 配置 更 新 通道 
当 我 们 执行 检测 更 新 以 后 ,弹出 的 检测 结果 对 话 框 中 也 是 可 以 配置 更 新 通道 的 。 操 作 步 骤 : 菜 


单 栏 --> Android Studio --> Check for Updates .… 在 弹出 的 对 话 框 中 选择 Update 进 入 更 新 通 
道 配置 界面 ， 


单独 下 载 最 近 更 新 的 版 本 


下 载 地 址 : http://tools.android.com/download/studio 


四 种 版 本 的 区 别 


Android Studio 提 供 了 四 种 更 新 通道 , 在 检测 更 新 时 分 别 会 检测 不 同 的 版 本 . 
Stable Channel: 稳定 版 本 

Beta Channel: 测试 版 本 Dev Channel: 开发 版 本 

Canary Channel: 4% EMA 


这 四 个 版 本 更 新 频率 从 Canary 往 上 乏 渐 递减 ,Canary 大 概 1 或 者 2 周 会 更 新 一 次 ，Beta 则 为 相对 
稳定 的 发 布 版 ， 而 Stable 则 是 正式 版 . 


另外 这 四 个 版 本 的 稳定 性 则 跟 其 更 新 频率 相反 , 1 CEM Canary LA i 3 © 


环境 问题 经 常会 经 常 困 扰 着 我 们 ,所 以 如 果 不 是 特别 需要 ， 我 们 当然 是 使 用 稳定 版 本 了 ， 如 果 
你 想 尝 鲜 , 当然 是 使 用 Canary Channel. 


Canary Channel 最 近 的 更 新 信息 : http://tools.android.com/download/studio/canary/latest 


提示 平台 和 插件 更 新 


Platform and Plugin Updates 


Ar j u S ready 


Mm Platform and Plugin Updates 


f=] 





Android Studio 项 目 和 模块 


Android Studio 中 的 两 个 重要 的 概念 : 项 目 (Project) 和 模块 (Module) . 
模块 (Module): 
Module 是 一 个 可 以 单独 的 运行 和 调试 的 application 或 公共 库 , 它 相 当 于 Eclipse 当 中 的 Project. 


我 们 通常 把 一 些 公共 的 代码 放 到 module 当 中 , 当 你 的 APP 需 要 添加 一 些 依赖 的 库 或 者 需要 依 站 
一 些 公共 的 项 目 时 可 以 导入 module. 


每 个 module 中 都 有 自己 的 build.gradle 文 件 用 来 配置 模块 的 构建 任务 . 


在 build.gradle 文 件 中 我 们 可 以 配置 SDK 版 本 、 构 建 工 具 版 本 、 应 用 程序 版 本 、 打 包 参 数 、 模 
块 的 依赖 等 等 . 


项 目 (Project): 


Project 可 以 理解 为 一 个 完整 的 APP 项 目 , 它 由 application module 和 一 些 依赖 的 module 组 成 , 相 
当 于 Eclipse 当中 的 workspace. 


一 个 Project 中 有 多 个 module。 


Project 中 也 有 一 个 build.gradle 文 件 用 来 指定 构建 的 项 目 和 任务 , 当 你 导入 或 新 建 一 个 Module 
时 ,build.gradle 会 自动 更 新 . 


项 目 VS 模块 


Module 相 当 于 Eclipse 当 中 的 Project.Project 相 当 于 Eclipse 当 中 的 workspace. 一 个 Project 中 可 
以 包含 多 个 Module.Module 中 的 build.grade 用 于 配置 模块 的 构建 任务 .Project 中 的 build.grade 
用 于 定 构 建 的 项 目 和 任务 . 


第 二 章 新 建 


Android Studio 提 供 了 非常 方便 的 功能 来 新 建 和 导入 项 目 、 模 块 、 文 件 以 及 各 种 资源 ， 它 集成 
了 非常 丰富 的 模板 来 帮助 我 们 快速 创建 不 同类 型 的 文件 。 熟 悉 这 些 模板 和 工具 的 使 用 ， 会 大 
大 提高 我 们 的 开发 效率 。 


创建 项 目 


首先 ， 先 指出 Android Studio 中 的 两 个 概念 。 Project 和 Module 。 在 Android Studio ¥ > 
Project 4) 2X22 Lt # la] > Module 为 一 个 具体 的 项 目 。 


在 Eclipse 中 ， 我 们 可 以 同时 对 多 个 Eclipse 的 Project 进行 同时 编辑 ， 这 些 Project 在 同 
ears WOKS pace 之 中 。 在 Android Studio 中 ， 我 们 可 以 同时 对 多 个 Android Studio 的 Module 
进行 同时 编辑 ， 这 些 Module 在 同一 个 Project 之 中 。 


Eclipse 的 Project 等 同 于 Android Studio 的 Module 。 
Eclipse 的 workspace 等 同 于 Android Studio 的 Project ° 


本 文中 所 说 到 的 项 目 指 的 是 Android Studiotg Module ° Android Studio 创 建 一 个 项 目 ， 首 先 
要 先 创 建 Project 。 但 是 你 创建 项 目的 同时 ，Project 自动 创建 了 ， 因 此 很 多 人 容易 混淆 这 两 
种 概念 。 


Android Studio 创 建 项 目的 过 程 ， 其 实 就 是 Eclipse 创建 项 目 过 程 的 细 分 化 。 Eclipse 许多 在 
个 页 面 设 置 的 内 容 ，Android Studio 拆 分 成 了 多 个 页 面 ， 因此， 创建 项 目的 过 程 其 实 并 不 复 


Android Studio 有 两 种 创建 项 目的 方法 。 


第 一 个 是 在 Android Studio 起 始 页 选择 Start a new Android Studio project 。 


® Android Studio 


Recent Projects 





第 二 个 是 在 Android Studio 主 页 ， 选 择 File --> New Project ° 


Alt+Insert 


Ctrl+Alt+S 
Ctrl+Alt+Shift+S 


Ctrl+S 


Ctrl+Alt+¥ 


e Encod 





接 下 来 ， 我 们 会 看 到 这 个 页 面 。 


[E create New Projed =) 


New Project 


/以 Android Studio 


Configure your new project 





e Application name : 应 用 程序 的 名 称 。 它 是 app 在 设备 上 显示 的 应 用 程序 名 称 ， 也 是 在 
Android StudioProject 的 名 称 。 

e Company Domain : 公司 域名 。 影 响 下 面 的 Package name 。 默 认为 电脑 主机 名 称 ， 
当然 你 也 可 以 单独 设置 Package name 。 

e Package name : 应 用 程序 包 名 。 每 一 个 app 都 有 一 个 独立 的 包 名 ， 如 果 两 个 app 的 包 名 
相同 ，Android 会 认为 他 们 是 同一 个 app。 因 此 ， 需 要 尽量 保证 ， 不 同 的 app 拥 有 不 同 的 包 
名 。 

e Project localtion : Project 存放 的 本 地 目录 。 


以 上 内 容 设 置 完毕 ， 点 击 Next 。 


完 
接 下 来 ， 我 们 会 看 到 这 个 页 面 。 


(FF create New Projec 


New Project 
Android Studio 


Select the form factors your app will run on 


Different platforms require separate SDKs 





在 这 里 ， 你 可 以 你 的 Project 中 Module 的 类 型 以 及 支持 的 最 低 版 本 。 


Phone and Tablet : 表示 Module 是 一 个 手机 和 平板 项 目 。 

e TV : 表示 Module 是 一 个 Android TV 项 目 。 

Wear : 表示 Module 是 一 个 可 穿戴 设备 (例如 手表 ) 项 目 。 

e Glass : 表示 Module 是 一 个 Google Glass 项 目 (不 知道 Google Glass 是 什么 请 自 
行 搜索 ) 。 


你 可 以 同时 选择 多 个 类 型 ， 区 别 就 是 项 目 会 根据 你 选择 的 类 型 创建 一 个 或 多 个 Module 。 


Minimum SDK 表示 的 是 Module 支持 的 Android 最 低 版 本 。 根 据 不 同 的 用 户 可 以 选择 不 同 的 
版 本 。 你 可 以 点 击 Help me choose 来 查看 当前 Android 版 本 分 布 情况 。 现 在 这 个 时 代 ， 如 果 
你 的 项 目 支持 到 2.2 版 本 几乎 是 支持 了 所 有 的 Android 设 备 。 


VELA Bike Be > Ae Next 。 


接 下 来 ， 我 们 会 看 到 这 个 页 面 (由 于 我 的 Module 类 型 只 选择 了 Phone and Tablet ， 所 以 会 
有 这 个 页 面 。) 。 


$ Create New Projec 


Add an activity to Mobile 


Blank Act Blank Activity with Fragment Fullscreen Activit 


E ~ 





这 个 页 面 是 让 我 们 选择 是 否 创建 Activity 以 及 创建 Activity 的 类 型 。 你 可 以 选择 不 创建 
Activity ( Add No Activity ) 。 


如 果 你 选择 自动 创建 Activity，Android Studio 会 自动 帮 你 生成 一 些 代 码 。 根 据 Activity 
类 型 的 不 同 ， 生 成 的 代码 也 是 不 同 的 。 有 时 ， 你 能 从 这 些 自动 生成 的 代码 中 ， 学 到 很 多 
东西 ， 比 如 Fullscreen Activity 。 


选择 完毕 ， 点 击 Next 。 


接 下 来 ， 我 们 会 看 到 这 个 页 面 (上 一 步 中 ， 我 选择 了 Blank Activity 。) 。 


ji pe 
Pl Create New Pr 


Choose options for your new file 





Activity Name : 自动 创建 的 Activity 的 类 名 。 

Layout Name : 自动 创建 的 Activity 的 布局 文件 名 称 。 

Title :自动 创建 的 Activity 的 名 称 。 

e Menu Resource Name : 自动 创建 的 Activity 的 Menu 文件 名 称 。 


以 上 内 容 设置 完毕 ， 点 击 Next 。 你 将 会 看 到 这 个 进度 条 。 这 个 表示 ，Android Studio 正 在 创 
建 和 编译 你 的 项 目 。 


Gradle: Initialize build 





目 创建 编译 完毕 ， 会 进入 Android Studio 的 主页 ， 你 将 看 到 下 面 的 界面 。 到 这 里 项 目 已 经 创 





(® My Application - [E\androi workspace\MyApplication] - [app] - ..\app\src\main\res\layout\activity_mainml - Android studio101 ”RU — 要 hi hm ik E (son x) 


a = a ui 


创建 模块 


如 果 你 已 经 有 一 个 项 目 ， 你 想 在 这 个 项 目 中 创建 一 个 Module ， 你 可 以 选择 File --> New 
Module ° 


这 样 ， 会 在 当前 的 目录 下 创建 一 个 Module ， 而 不 是 在 一 个 新 的 窗口 中 ， 单 独创 建 Project 
和 Module 。 


之 后 ， 你 就 会 看 到 下 面 的 界面 。 


New Module 


/以 Android Studio 


Choose Module Type 


Select an option below to create your new module 





同样 的 道理 ， 你 可 以 设置 项 目 类 型 ， 但 是 ， 由 于 你 现在 是 创建 一 个 Module ， 所 以 只 能 选择 


一 种 类 型 。 


下 方 的 4 个 选项 代表 着 不 同 的 意义 : 


Android Library : 创建 一 个 Android Library 的 Module 。 

Import Existing Project : 导入 其 他 项 目 为 一 个 Module ， 寻 入 的 项 目 可 以 是 Eclipse 
ADT 项 目 ， 也 可 以 是 Gradle 项 目 ( Gradle 只 是 项 目 构建 工具 ，Eclipse 中 也 是 可 以 使 
用 的 ) 。 

Import .JAR or .AAR Package : +A JAR 或 者 AAR 文件 为 一 个 Module 。 

e Java Library : 创建 一 个 Java 的 Module ， 主 要 用 于 编写 Java 的 工具 包 。 


选择 完毕 ， 点 击 Next 。 其 余 步 又 ， 和 创建 项 目 几 乎 一 样 ， 就 不 在 元 述 了 。 


创建 模块 
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创建 库 


创建 应 用 程序 模块 


操作 步骤 : 


第 1 步 :菜单 栏 : File 一 > New 一 > New Module 
然后 弹出 创建 模块 界面 


Android Studio 中 支持 这 么 多 种 模块 类 型 ,我 们 要 新 建 的 模块 类 型 为 应 用 程序 ,因此 要 选择 
(Phone & Table Module] . 


第 2 步 : 选择 [Phone & Table Module] 一 > Next 一 > 配置 新 的 模块 
第 3 步 : Next 一 > 选择 一 个 Activity 模 板 

我 们 以 Login Activity 模 板 作为 演示 。 

第 4 步 :Next 一 > 配置 Activity 

这 里 有 对 即将 创建 的 Activity 模 板 的 说 明 : 


创建 一 个 新 的 登录 Activity, 允许 用 户 选择 使 用 Google + 登录 ,或 输入 email 地 址 和 密码 登录 ,或 
注册 你 的 APP 


我 们 这 里 使 用 默认 配置 


第 5 步 : Finish 一 > 新 建 应 用 程序 (Phone & Table Module) 模 块 成 功 


创建 Android 公 共 库 模块 


java 的 公共 库 是 直接 将 公用 代码 打 成 jar 包 ,android 的 公共 库 类 似 ,目的 都 是 为 了 代码 的 重用 .使 
用 android 公 共 库 还 可 以 使 项 目 模块 化 ,以 便 协同 开发 和 更 好 的 扩展 . 


操作 步骤 


菜单 栏 : File 一 >New 一 > New Module 
然后 弹出 新 建 Module 对 话 框 ,选择 Android Library 
Next 一 > 输入 Library name 和 Module name 


Finish 一 > 结果 


为 应 用 程序 添加 模块 依赖 : 


操作 步 又: 


打开 Project Structure 一 > 选择 你 要 操作 的 应 用 程序 一 > 添加 已 存在 项 目 中 的 模块 作为 依赖 


4% Android Library 打 包 成 .aar 


打开 Gradle 工 具 窗 口 ,找到 Android Library 模 块 . 在 build 任 务 中 双击 assemble. 
任务 执行 成 功 以 后 ,在 mylibraryVbuildVoutputsVaar 目 录 下 就 会 打出 .aar 格 式 的 包 . 


默认 Debug 和 Release 的 AAR 包 都 会 打出 来 ,当然 你 也 可 以 选择 只 打 Debug 的 包 , 双 击 
assembleDebug 任 务 就 可 以 了 . 只 打 Release 的 包 同 理 . 


导入 Android Studio 8 


当 你 从 网 络 上 或 者 其 他 地 方 获取 到 一 份 Android Studio 项 目 源码 时 ， 你 希望 能 够 导入 到 
Android Studio 中 。 首 先 ， 你 需要 先 对 这 份 源码 进行 一 些 修 改 。 


打开 Android Studio， 选 择 Open an existing Android Studio project 。 
® Android Studio Lo | lS 





在 弹出 的 路 径 选 择 框 中 ， 选 择 你 要 导入 的 Android Studio 项 目 ， 点 击 OK ° 
讲解 23 
然后 会 弹出 和 讲解 11 相同 的 页 面 ， 同 样 ， 和 讲解 11 进行 一 样 的 设置 即 可 。 


Building ‘workspacel' G 


dle: Resolve dependencies ‘:classpath' 





之 后 的 步骤 ， 同 讲解 11 > ALR Aik © 


其 他 导入 方式 


导入 一 个 项 目 除 了 在 Android Studio 起 始 页 进行 导入 之 外 ， 你 也 可 以 在 Android Studio 主 页 中 
进行 导入 。 


File --> Import Project 或 者 File --> Import Module 。 


Alt+Insert 


Ctrl+Alt+S 
Ctrl+Alt+Shift+S 
b 


Ctrl +S 


Ctrl+Alt+¥ 





导入 的 过 程 和 前 面 的 讲解 都 是 一 样 的 ， 就 不 在 玖 述 了 。 


导入 eclipse 项 目 


原文 地 址 : http:VVask.android-studio.orgV?VarticleV21 
本 篇 教程 中 使 用 Eclipse ADT 版 本 23.0.4。 请 尝试 更 新 到 该 版 本 。 


Android Studio 默 认 使 用 Gradle 构建 项 目 ，Eclipse 默认 使 用 Ant 构 建 项 目 。 建 议 Android 
Studio 导 入 项 目 时 ， 使 用 Gradle 构建 项 目 。 


导入 Eclipse 项 目 


本 例 中 ， 使 用 到 的 Eclipse 项 目 结构 如 图 : 


导入 eclipse 项 





B Package Explorer x 时 E B vo g | 
s É appcompat_v7 
E src 
Gs gen [Generated Java Files] 
= Android 5.0.1 
= Android Private Libraries 
Gs bin 
Gs libs 
i res 
回 AndroidManifest.xml 
project.properties 
README.txt 
4 2 e-demo 
4 [地 src 
4 册 aa.bb.cc 
> [J] MainActivityjava 
> E3 gen [Generated Java Files] 
> BA Android 5.0.1 
> BA Android Private Libraries 
> BA Android Dependencies 
& assets 
» ES bin 
» ES libs 
4 & res 
> © drawable-hdpi 
& drawable-ldpi 
> © drawable-mdpi 
> © drawable-xhdpi 
> © drawable-xxhdpi 
> & layout 
> (> menu 
> © values 
> B values-v11 
> © values-v14 
回 AndroidManifestxml 
tam i¢_launcher-web.png 
回 lint.xml 
proguard-project.txt 
project.properties 

















e-demo 为 主 项 目 ，appcompat v7 > library 项 目 。 


导入 Generate Gradle build files 项 目 


Google 官 方 建议 是 通过 本 方法 进行 Android Studio # Eclipse 项 目 。 


这 种 方式 有 一 个 好 处 就 是 兼容 Eclipse 的 文件 目录 结构 ， 通 过 版 本 控制 中 的 文件 过 滤 ， 可 以 
在 一 个 项 目 组 中 ， 同 时 使 用 Eclipse 和 Android Studio 。 


讲解 1 


File --> Export 





Edit Refactor Source Navigate Search Project Run W 





New Alt+Shift+N > 
Open File... 
Close Ctrl+W 
Close All Ctrl+Shift+W 
Save Ctrl+S 
Save As... 
Save All Ctrl+Shift+S 
Revert 
Move... 

FA Rename... F2 

$) Refresh F5 
Convert Line Delimiters To b 
Print... Ctrl+P 
Switch Workspace > 
Restart 

gy Import... 

By Export... 
Properties Alt+Enter 


1 AndroidManifest.xml [e-demo] 

2 MainActivity.java [e-demo/src/aa/bb/cc] 
3 project.properties [e-demo] 

4 project.properties [appcompat_v7] 


Exit 





讲解 2 


选择 导出 类 型 。 选 择 Android --> Generate Gradle build files 。 


导入 eclipse 项 目 


Select an export destination: 


type filter text 


> @ General 
4 © Android 
i Export Android Application 
b & C/C++ 
> & Install 
> & Java 
> @ Plug-in Development 
> @ Run/Debug 
> @& Tasks 
> && Team 
> & XML 





@ 





点 击 Next 。 


讲解 3 
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导入 eclipse 项 目 


Import Instead? 


Consider importing directly into Android Studio instead of 
exporting from Eclipse 





Recent versions of Android Studio now support direct import of ADT projects. 


There are advantages to importing from Studio instead of exporting from Eclipse: 

- It can replace jars and library projects with Gradle dependencies instead 

- On import, it creates a new copy of the project and changes the project structure 
to the new Gradle directory layout which better supports multiple resource directories. 

- It can merge instrumentation test projects into the same project 

- Android Studio is released more frequently than the ADT plugin, so the import 
mechanism more closely tracks the rapidly evolving requirements of Studio Gradle 
projects. 


If you want to preserve your Eclipse directory structure, or if for some reason import 
in Studio doesn't work (please let us know by filing a bug), continue to export from 
Eclipse instead. 





点 击 Next 。 
讲解 4 
选择 要 导出 的 项 目 。 
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导入 eclipse 项 目 


Generate Gradle Build files 


Generates Gradle build files based on the configuration of the 
Java projects 


Select the projects to use to generate the Gradle buildfiles: 


V| ÉS e-demo 
(7) & appcompat_v7 





为 我 的 e-demo 项 目 依赖 了 appcompat_v7 项目， 所 以 我 将 e-demo 和 appcompat_v7 
都 选择 了 导出 。 


点 击 Next 。 
讲解 5 


最 终 确认 要 导出 的 项 目 。 
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导入 eclipse 项 目 


Generate Gradle Build files 


Generates Gradle build files based on the configuration of the 
Java projects 





Please review the export options. 
Project root 
E:\workspacel 


Exported Modules 


Force overriding of existing files 








Force overriding of existing files 表示 窗 盖 导出 文件 。 使 用 Generate Gradle build files 
的 方式 导出 项 目 ， 会 在 项 目 目录 中 生成 一 些 文件 。 这 里 的 覆盖 文件 指 的 就 是 覆盖 这 些 可 能 已 
经 生成 过 的 文件 。 如 果 你 之 前 有 使 用 这 种 方式 导出 过 项 目 ， 建 议 勾 选 。 


点 击 Finish 。 
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导入 eclipse 项 目 


Generate Gradle Build files 


Generates Gradle build files based on the configuration of the 
Java projects 





Export successful. 


Exported 2 modules 
Root folder: E:\workspacel 


Choose ‘import project’ in Android Studio 
and select the following file: 
E:\workspace1\build.gradle 


Do NOT import the Eclipse project itself! 








讲解 6 
这 一 步 没 有 什么 好 说 的 ， 直 接点 击 Finish 。 
讲解 7 


Finish 点 击 完 毕 ， 并 没有 弹出 窗口 显示 导出 的 项 目 ， 就 好 像 什 么 事情 都 没有 做 一 样 。 其 实 ， 
使 用 这 个 方式 导出 项 目 ， 是 在 项 目 中 添加 了 一 些 文件 ， 我 们 可 以 到 项 目 目 录 下 去 看 一 看 这 些 
生成 文件 。 


工作 空间 目录 下 
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导入 eclipse 项 目 


> 文档 (E) » workspacel > 


共享 ” ”新 建文 件 夫 
名 称 
J metadata 
出 appcompat_v/7 
J e-demo 


dJi gradle 

|_| build.gradle 
|_| gradlew 
gradlew.bat 
|_| settings.gradle 


e-demo 目录 下 


， SS (E) » workspacel >» e-demo > 


共享 ”新 建文 件 夫 


A 


修改 日 期 


2014/12/16 周二 .… 
2014/12/16 AZ... 
2014/12/16 周二 .. 
2014/12/16 周二 .… 
2014/12/16 周二 .… 
2014/12/16 Fix... 
2014/12/16 周二 .… 
2014/12/16 AZ... 


GRADLE 文件 
文件 

Windows HAM... 
GRADLE 文件 


大 小 


5 KB 
3 KB 





名 称 修改 日 期 类 型 大 小 

I settings 2014/12/16 周二 ...。 文件 夫 
| assets 2014/12/16 周二 ..。 3s | 
J bin 2014/12/16 B=... 文件 夫 

Di gen 2014/12/16 AZ.. XE 

Ù libs 2014/12/16 x... Stes 

i res 2014/12/16 A.. sce 

sre 2014/12/16 AX... Stes 

[| .classpath 2014/12/16 i=... CLASSPATH 文件 1 KB 
|] «project 2014/12/16 Z... PROJECT 文件 1 KB 
AndroidManifest.xml 2014/12/16 =... XML 文档 1 KB 
|_} build.gradle 2014/12/16 i=... GRADLE 文件 2 KB 
fam) i¢_launcher-web.png 2014/12/16 Z... PNG 文件 51 KB 
lint.xml 2014/12/16 A=... XML 文档 1 KB 
|} proguard-project.txt 2014/12/16 周二 ..。 文本 文档 1 KB 
|_| project.properties 2014/12/16 AZ... PROPERTIES 文件 1KB 


appcompat_v7 目录 下 
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E —™ QQ e 
> 文档 (E:) >» workspacel ， appcompat v7 > 


m = 一 —_ ` —_ — _— 








名称 修改 日 期 类 型 大 小 

di settings 2014/12/16 AZ.. 文件 3 

hh bin 2014/12/16 AZ.. 文件 去 

d gen 2014/12/16 Ax... 文件 夫 

) libs 2014/12/16 Ax... 文件 去 

d res 2014/12/16 AZ... 文件 去 

W sre 2014/12/16 AZ. 文件 去 

|_| classpath 2014/12/16 周二 ... CLASSPATH 文件 1 KB 
|_|] .project 2014/12/11 FAD... PROJECT 文件 1KB 
“| AndroidManifest.xml 2014/12/11 AN.. XML 文档 1 KB 
| | build.gradle 2014/12/16 =... GRADLE 文件 2 KB 
|_| project.properties 2014/12/16 周二 PROPERTIES 文件 1 KB 
国 README.txt 2014/12/11 A... 文本 文档 1 KB 


我 们 可 以 发 现 : 在 工作 空间 目录 下 ， 多 出 了 gradle 文件 夹 和 build.gradle ` build.gradle 
、gradlew ` gradlew.bat ` settings.gradle 文件 ; 在 e-demo 目录 下 多 出 了 build.gradle 
文件 ; 在 appcompat v7 目录 下 多 出 了 build.gradle 文件 。 这 些 文 件 和 文件 夹 都 和 Gradle 
有 关系 ， 用 于 构建 项 目 。 这 些 文件 以 及 文件 夹 的 作用 ， 我 们 以 后 再 说 。 

讲解 8 

由 于 Eclipse 的 ADT 插件 已 经 很 久 没 有 更 新 了 ， 自 动 生成 的 Gradle 编译 设置 已 经 跟 不 上 
Android Studio 的 更 新 速度 ， 所 以 我 们 需要 手动 修改 一 些 内 容 。 


打开 工作 空间 目录 下 的 gradle --> wrapper --> gradle-wrapper.properties 。 修 改 一 下 内 
È : distributionUrl=http\:W/services.gradle.org\/distributionsVgradle-a.b.c-all.zip -- 
>distributionUrl=https\:VVservices.gradle.orgVdistributionsVgradle-2.2.1-all.zip 


打开 工作 空间 目录 下 的 build.gradle 文件 。 修 改 以 下 内 容 : 


classpath 'com.android.tools.build:gradle:0.x.+' --> classpath 
‘com.android.tools.build:gradle:1.0.0° ° 


之 所 以 这 么 设置 ， 是 因为 : Eclipse 导出 的 Gradle 设置 已 经 不 是 Android Studio 1.0 所 支持 
的 Gradle 已 经 Gradle 插 件 版 本 ， 需 要 手动 更 为 支持 的 版 本 。 否 则 轻 则 必须 不 能 离线 导入 项 
目 ， 重 则 项 目 导 入 失败 。 


讲解 9 


打开 Android Studio， 选 择 Open an existing Android Studio project ° 





® Android Studio 





讲解 10 


此 时 会 弹出 一 个 框 ， 让 你 选择 文件 天 ， 这 个 时 候 需要 注意 的 就 是 ， 你 需要 选择 原来 的 Eclipse 
的 工作 空间 目录 ， 而 不 是 e-demo 目录 。 


导入 eclipse 项 目 





(ts Package Explorer 2 
4 (9 appcompat_v7 
E src 
3 gen [Generated Java Files] 
= Android 5.0.1 
= Android Private Libraries 
fs bin 
Gs libs 
色 res 
回 AndroidManifest.xml 
project.properties 
README.txt 
s | e-demo 
4 @ src 
4 册 aa.bb.cc 
> [D MainActivityjava 
> E3 gen [Generated Java Files] 
> BA Android 5.0.1 
> BA Android Private Libraries 
> BA Android Dependencies 
& assets 
> & bin 
> & libs 
4 El res 
> @ drawable-hdpi 
& drawable-ldpi 
> E> drawable-mdpi 
> © drawable-xhdpi 
> E> drawable-xxhdpi 
> @ layout 
> & menu 
> & values 
> E> values-v11 
> @& values-v14 
回 AndroidManifest.xml 
tam i¢_launcher-web.png 
回 lintxml 
proguard-project.txt 
project.properties 









































ae SK, Ua ae 





点 击 OK 。 


讲解 11 
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设置 导入 选项 。 





r 
M Import Project from Gradle 











此 处 有 一 些 比较 重要 的 设置 需要 讲解 一 下 。 


e Gradle project : 此 处 通常 显示 的 路 径 并 不 是 你 的 Eclipse 的 工作 空间 的 目录 ， 而 是 
Eclipse 的 工作 空间 的 目录 中 的 gradle 路 径 。 你 需要 手动 删除 后 面 的 gradle > ENA A 
导入 ， 你 是 看 不 到 你 的 代码 的 ， 只 能 看 到 gradle 目录 下 的 内 容 。 

e Create directories for empty content roots automatically : 不 是 很 明白 它 的 作用 ， 一 
I SATA BP AT o 

e Use default gradle wrapper(recommended) 和 Use local gradle disribution : 这 两 
个 是 让 你 设置 使 用 的 Gradle ° RUA 4# Use default gradle 
wrapper(recommended) ， 我 们 需要 手动 匀 选 Use local gradle disribution ° 

e Gradle home : 4) % Use local gradle disribution 后 此 项 编程 可 编辑 状态 ， 默 认 的 此 
处 的 地 址 为 Android Studio 安 装 目录 中 的 Gradle 路 径 地 址 。 此 处 可 能 会 有 一 些 错误 的 区 


4 > TRARA : Gradle location is incorrect 。 而 你 的 这 个 目录 下 ， 确 实 是 有 Gradle 
的 。 产 生 这 个 问题 的 原因 ， 很 可 能 是 因为 Gradle home 选项 中 ， 路 径 中 的 斜 杠 为 V 而 不 
是 凡 。 你 需要 点 击 左右 的 文件 选择 按钮 ， 重 新 选择 到 Android Studio 安 装 目 录 中 的 
**Gradle ， 问 题 即 可 解决 。 

e Offline work : 设置 Gradle 使 用 离线 的 方式 导入 项 目 。 你 可 以 名 选 也 可 以 不 匀 选 。 如 果 
你 有 进行 讲解 8 的 操作 ， 你 则 可 以 勾 选 ， 以 离线 的 方式 进行 编译 。 


点 击 OK 。 之 后 便 会 看 到 编译 进度 条 ， 根 据 每 个 人 机 器 的 配置 ， 编 译 的 时 间 不 同 。 





之 所 以 有 这 个 弹 框 ， 是 因为 Android StudioR WE A JAVA 1.7 进行 编译 ， 如 果 你 的 项 目 不 是 
1.7 ， 则 会 弹 框 让 你 选择 。 建 议 选择 Yes ， 因 为 当 你 使 用 JAVA 1.7 的 时 候 ， 只 要 不 使 用 
JAVA 1.7 的 资源 自动 释放 这 个 新 特性 ， 能 够 完美 得 兼容 JAVA 1.6 的 Android 设 备 。 


如 果 你 看 到 下 面 这 个 界面 ， 说 明 你 已 经 导入 成 功 了 。 





直接 导入 Eclipse 项 目 

如 果 不 使 用 Generate Gradle build files 导出 项 目 ， 可 以 使 用 Android Studio 直 接 打 开 
Eclipse 工作 空间 ， 进 行 项 目 导入 。 

不 使 用 Gradle 编译 项 目 


这 种 方式 可 以 兼容 Eclipse 的 文件 目录 结构 ， 通 过 版 本 控制 中 的 文件 过 滤 ， 可 以 在 一 个 项 目 
组 中 ， 同 时 使 用 Eclipse 和 Android Studio。 但 是 在 Android Studio 中 并 不 是 使 用 Gradle 构建 
项 目 ， 而 是 使 用 的 Ant ° 
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打开 Android Studio， 选 择 Import Non-Android Studio project 。 


® Android Studio eS XxX 


cent Projects 





在 弹出 的 目录 选择 框 中 ， 选 择 Eclipse 的 工作 空间 。 
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接 下 来 回 让 你 选择 编译 环境 。 选 择 Create project from existing sources 。 





Gi 


® Import Project 
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r 
® Import Project 











i @ Android Studio Project 名 称 以 及 存放 目录 。 一 般 默认 即 可 。 


At Next 。 
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r 
* Import Project 











选择 资源 文件 以 及 资源 文件 夹 。 根 据 你 需要 导入 的 项 目 进 行 名 选 。 选 择 一 个 项 目的 时 候 ， 你 
需要 选择 它 依赖 的 Library 项 目 以 及 他 的 src 和 gen 目录 。 


选择 完 Hey 5 + Next ° 





r 
® Import Project 











选择 要 导入 的 jar。 第 一 个 mylyn 是 Eclipse 插件 的 内 容 ， 我 们 需要 手动 过 滤 掉 ， 其 他 的 根 
据 你 的 需要 ， 进 行 选择 。 





r 
® Import Project 


v7 (E:\worksp: 














r 
® Import Project 


default by all project modules. 


SDK ‘Android API 21 Platform’ 





Documentation P 








先 择 编译 的 SDK 。 在 这 里 ， nee %4 Android SDK ， 最 好 和 之 前 使 用 Eclipse 时 使 用 的 
SDK 一 样 。 同 样 ， 你 也 可 以 再 次 进行 一 些 简 单 的 环境 设置 ， 在 此 就 不 说 了 。 





r 
® Import Project 





Finish 








选择 识别 出 的 AndroidManifest.xml 文件 。 默 认 全 部 勾 选 即 可 。 
点 击 Finish ，Android Studio 就 开始 导入 项 目 了 。 
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在 导入 的 过 程 中 ， 如 果 Android Studio 识 别 出 原 项 目的 依赖 关系 ， 便 会 弹出 对 话 框 让 你 进行 选 
择 。 如 果 想 保持 之 前 的 依赖 关系 ， 点 击 OK 即 可 。 





当 你 看 到 这 个 界面 ， 就 表示 导入 成 功 了 。 项 目 使 用 Ant 构建 ， 并 不 是 Android Studio 默认 的 
Gradle 。 
使 用 Gradle 编译 项 目 


本 方法 有 一 个 缺点 就 是 ， 一 次 只 能 导入 一 个 Eclipse 项 目 。 对 于 那些 只 使 用 到 了 官方 系列 的 
支持 包 的 Eclipse 项 目 来 说 ， 会 方面 很 多 ， 而 且 同 时 兼容 Eclipse 文件 目录 结构 。 
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打开 Android Studio， 选 择 Import Non-Android Studio project 。 


® Android Studio Lo | (So) 


x Welcome to Android Studio 


Recent Projects 





在 弹出 的 目录 选择 框 中 ， 选 择 你 想 导入 的 项 目 所 在 的 目录 ， 而 不 是 Eclipse 的 工作 空间 。 


ve Select Eclipse or Gradle Project to Impo 
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Android Studio 识 别 出 你 的 项 目 是 一 个 Eclipse Android 项 目 ， 它 将 重新 使 用 Gradle 构建 项 
Bo 


Android Studio 会 完整 复制 项 目 文件 到 一 个 新 的 目录 中 ， 你 需要 设置 这 个 新 目录 的 地 址 。 





r - 
® Import Project from ADT (Eclipse Android) Zs 














设置 完毕 ， 点 击 Next 。 
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将 之 前 Ant 架构 改变 为 Gradle 架构 。 








r 
网 Import Project from ADT (Eclipse Android) 








Finish 





e Replace jars with dependencies,when possible : 将 Ant 的 jar 依赖 关系 使 用 
dependencies 重 构 。 

e Replace library sources with dependencies,when possible : 74 Ant 的 library 项 目 
的 依赖 关系 使 用 dependencies 重 构 。 

e Create Gradle-style(cameCase) module names :使 用 Gradle 的 样式 构建 Android 
Studio 的 Module 名 称 。 


建议 全 选 ， 点 击 Finish 。Android Studio 开 始 编译 项 目 ， 同 时 进入 Android Studio 主 页 面 。 


同样 的 ， 在 编译 的 过 程 中 ， 依 然 会 提示 你 语言 等 级 的 问题 ， 选 择 Yes 。 


已 
-可 


Android Studio 项 目 ， 指 的 是 使 用 Gradle 进行 构建 的 项 目 。 默 认 的 文件 结构 如 下 : 





A Android Studio% £ 


project-name+ app/ 


+ 


+ 
+ 
+ 
+ 


+ 


src/ 
main/ 
assets/ 
java/ 
package 


res/ 


+ drawable/ 


+ 


+ 


+ 


有 的 
的 。 


layout 
values 


Androidmanifest.xml 
build.gradle 
gradle/ 
wrapper/ 
gradle-wrapper.jar 
gradle-wrapper.properties 
build.gradle 
gradlew 
gradlew.bat 
settings.gradle 


一 些 Android Studio 项 目 有 对 Eclipse 做 兼容 处 理 ， 项 目 结构 看 起 来 和 Eclipse 是 相同 


导入 JarVAAR 


.aar 格式 的 包 是 Android 独 有 的 第 三 方 库 (Android Library), 包含 了 可 重用 的 java 文 件 和 
Android 组 件 . 我 们 可 以 通过 新 建 module 创 建 自己 的 Android Library, 然 后 打包 成 .aar 格 式 的 包 与 
别人 共享 ,使 用 方法 跟 jar 包 基本 一 样 . 
导入 步骤 : 
菜单 栏 : File 一 > New 一 > New Module... 一 > Import .JARV.AAR Package 
选择 aar 包 存放 路 径 , 并 给 子 项 目 命名 . 
完成 后 可 以 看 到 作为 模块 导入 的 .aar 文 件 . 
mylibrary-debug 的 构建 文件 build.gradle: 

configurations.create\("default"\) 


artifacts.add\("default", file\('mylibrary-debug.aar'\)\) 


Project 的 settings.gradle 文 件 中 自动 添加 了 mylibrary-debug 模 块 : 


include ':app', ':phonetabletmodule', ':mylibrary', ':mylibrary-debug' 


新 建 类 和 文件 


Android Studio 新 建 类 时 可 以 先 择 多 个 常用 的 类 模板 . 


操作 步骤 


菜单 栏 一 > File 一 > New 一 > Java Class 一 > 输入 类 名 ,选择 类 模板 


增加 So 文件 


JNI 是 什么 ? 


Android 系 统 的 底层 库 是 由 cVc++ 编 写 ， 上 层 Android 应 用 程序 和 应 用 程序 框架 
JNI (JavaNative Interface) 调 用 底层 接口 . 


Android 使 用 JNI 开 发 分 两 种 情况 : 一 是 使 用 已 经 编译 好 的 .So 动态 库 ; 二 是 使 用 CVc++ 源 代码 
开发 . 


一 些 第 三 方 的 库 出 于 性 能 或 代码 安全 的 目的 ,会 将 核心 代码 用 CVC++ 来 实现 ,然后 提供 编译 好 的 
so 文件 或 jar 包 给 我 们 . 


So 文件 是 什么 ? 


Android 中 用 到 的 so 文件 是 一 个 c++ 的 函数 库 ，apk 或 jar 包 中 调用 so 文件 时 ， 需 要 将 对 应 So 文 
件 打包 进 apk 或 jar 包 


如 何 加 载 s0 文 件 ? 

假设 你 的 so 文件 为 :libBaiduMapSDK_v350_1.so 

这 样 加 载 : 

String libName = "BaiduMapSDK_v350_1"; W 注意 : 库 名 libName, 没有 前 组 lib 和 后 缓 .So 
System.loadLibrary( libName ); VV 在 使 用 前 一 定 要 先 加 载 

SO 文件 应 该 放 在 哪里 ? 


在 Eclipse 中 我 们 将 so 文件 放 到 libs 目 录 下 就 可 以 了 , 那么 在 AndroidStudio 中 应 该 将 so 文件 放 到 
哪里 呢 ? 


放 到 moduleNameVsrcVmainVijniLibs 目 录 下 ， 如 果 没 有 jinLibs 目 录 就 新 建 一 个 
armeabi、armeabi-v7a、mips、Xx86 这 四 个 文件 夹 是 干 嘛 的 呢 ? 

表示 四 种 不 同 的 cpu 类 型 ， 不 同 的 cpu 的 特性 不 一 样 ,在 使 用 So 文件 时 注意 区 分 . 
可 以 直接 复制 so 文件 粘贴 到 对 应 的 文件 夹 下 


ok 之 后 so 文件 就 进来 啦 ， 


4! 32 Fragment x 4} 


创建 一 个 Fragment 的 一 般 步 骤 : 
第 1 步 : 在 Layout 目 录 下 创建 Fragment 的 布局 文件 . 


第 2 步 : 创建 一 个 类 文件 ,继承 Fragment 或 者 Fragment 子 类 ,并 在 onCreateView 方 法 中 加 载 布 局 
文件 . 


第 3 步 : 在 Activity 的 布局 文件 中 声明 FragmentLayout. 
使 用 模板 基本 上 可 以 自动 生成 第 1 步 和 第 2 步 . 


如 何 使 用 Android Studio 提 供 的 模板 快速 创建 Fragment 及 其 所 用 到 的 布局 文件 呢 ? 


操作 步 又: 

菜单 栏 : File 一 > New 一 > Fragment 

Fragment(Blank): 创 建 一 个 空白 的 Fragment 
Fragment(List): 创 建 一 个 空 的 Fragment, 它 包含 一 个 网 格 列表 . 


Fragment(with a + 1 button): 创 建 一 个 带 有 Google Plus +14% 42 4% Fragment 


创建 一 个 空白 的 Fragment 


点 击 【Fragment(Blank)】 一 > 然后 弹出 【New Android Component】 界 面 ; 
e FragmentName: 自 定义 的 Fragment 类 名 , 会 继承 Fragment. 本 例 中 为 BlankFragment. 


e Create Layout XML?: 如 果 勾 选 ,会 同时 创建 BlankFragment 类 对 应 的 布局 文件 ,并 在 
BlankFragment 类 中 自动 添加 加 载 该 布局 文件 的 代码 . 


e Fragment Layout Name: BlankFragment 类 对 应 的 布局 文件 名 ,会 根据 类 名 自动 生成 ,可 自 


e Include fragment factory methods?: 如 果 勾 选 ,会 在 BlankFragment 类 中 生成 工厂 方法 . 


e Include interface callback?: 如 果 义 选 ,会 在 BlankFragment 类 中 生成 回调 接口 . 


创建 一 个 Fragment(List) 


点 击 【Fragment(List)】 一 > 然后 弹出 【New Android Component) 3+ @: 


Package name: 包 名 

Object Kind: 对 象 类 型 

Fragment class name: Fragment 类 的 名 字 

Column Count: 网 格 的 列 数 

Object content layout file name: 对 象 内 容 布 局 文件 名 
List layout file name: 列表 布局 文件 名 

Adapter class name: Adapter 类 名 


Al 32 service x t+ 


操作 步 又: 

菜单 栏 : File 一 > New 一 > Service 

然后 弹出 【New Android Component) %@: 

在 这 里 可 以 创建 一 个 service 组 件 ,并 添加 到 AndroidManifest.xml 文 件 中 . 
e Class Name: 类 名 ,会 继承 Service. 
e Exported: Service 的 属性 ,表示 是 否 支持 其 它 应 用 调用 当前 组 件 . 
e Enable:Service 的 属性 ,表示 该 服务 是 否 能 够 被 实例 化 . 


使 用 默认 配置 ,然后 创建 成 功 . 


创建 自 定义 组 件 


有 时 Android 提 供 的 组 件 无 法 满足 我 们 的 需求 ,因此 需要 自 定义 组 件 . 

创建 自 定义 组 件 的 一 般 步 又: 

1. 新 建 类 文件 ,要 继承 View 或 View 的 子 类 . 

2. 履 写 父 类 的 一 些 方法 . 

3. 使 用 自 定义 组 件 类 . 

Android Studio 会 通过 模板 帮 我 们 自动 生成 文件 ,并 履 写 方法 . 我 们 只 需要 根据 自己 的 实际 需求 
修 修 改 改 就 好 了 . 


操作 步 又: 
菜单 栏 : File 一 > New —>UI Component 一 > Custom View 
然后 弹出 【New Android Component) %+@: 
e Package name: 包 和 名 
e View Class: 自 定 义 的 类 名 , 按 约定 应 该 以 View 结 尾 . 
使 用 默认 配置 ,点 击 【Finish】 后 创建 成 功 . 
模板 帮 我 们 继承 了 View 并 和 履 写 了 方法 ,然后 我 们 根据 自己 的 需求 修改 代码 就 可 以 了 . 


另外 在 layout 目 录 下 会 自动 生成 一 个 sample_my view.xml 文 件 .这 是 一 个 示例 ,用 来 告诉 你 自 定 
义 组 件 怎 么 用 . 


创建 app widget 
App Widget 是 应 用 程序 的 窗口 小 部 件 , 它 可 以 被 谋 入 到 其 它 应 用 程序 中 (如 桌面 ) 并 接收 周期 性 
的 更 新 . 
创建 Widget 的 一 般 步 骤 : 
1 步 :在 resVlayout 目 录 下 创建 一 个 Widget 布 局 文件 . 
第 2 步 :创建 一 个 类 继承 AppWidgetProvider. 
第 3 步 : 在 resVxml 目 录 下 创建 一 个 XML 文件 ,用 来 定义 Widget 的 特性 . 
第 4 步 : 在 AndroidManifest.xml 中 声明 Widget. 


使 用 Android Studio 的 模板 功能 ,可 以 帮 有 我们 自动 完成 上 面 这 些 步骤 . 


操作 步骤 
菜单 栏 : File 一 > New 一 > Widget 一 > App Widget 
然后 弹出 【New Android Component) J @: 
Class Name: 类 名 ,继承 AppWidgetProvider.[ 图 片 ]Placement: Widget 放 在 哪儿 . 
1.Home-screen and Keyguard: 在 主屏 幕 和 锁 键 上 . 
2.Home-screen only: 仅 在 主屏 幕 上 . 
3.Keyboard only(API 17+): 仅 在 锁 键 上 (只 支持 Android4.2 及 以 上 版 本 ). 
Resizable(API 12+ ): Widget 是 否 可 调整 大 小 ,只 支持 Android 3.1 及 以 上 版 本 . 
1.Horizontally and vertically: 水 平和 重 直 显示 时 可 调整 . 
2.Only Horizontally: 仅 水 平时 可 调整 . 
3.Only vertically: 仅 重 直 时 可 调整 . 
4.Not resizable: 不 可 调整 . 

e Minimum Width: 最 小 宽度 ,参照 左边 预览 窗口 的 单元 格 . 

e Minimum Height: 最 小 高 度 ,参照 左边 预览 窗口 的 单元 格 . 

e Configuration Screen: 勾 选 后 会 生成 widgets 配 置 activity. 

后 


使 用 默认 配置 ,点 击 【Finish】 后 创建 成 功 . 


创建 app widget 


85 


SN sko 、 ~ 
创建 可 编译 的 资源 文件 
Android 项 目 中 可 编译 的 资源 文件 存放 在 res 目 录 下 ,在 R.java 中 会 自动 生成 这 些 资 源 文件 的 |D， 
可 以 通过 R.XXX.ID 来 访问 。 
光标 放 在 不 同 的 文件 夹 上 ,新 建 列 表 中 显示 的 选项 是 不 同 的 。 


1. 如 果 光 标 放 到 module 上 . 


操作 步骤 : 

菜单 栏 : File | 右 击 module 一 > New 一 > Android resource file 

弹出 [New Resource File] 对 话 框 

File name: 

新 建 的 资源 文件 名 . 

Resource type: 

资源 类 型 ,下 拉 列 表 中 会 列 中 我 们 前 面 讲 过 的 缺 省 的 资源 文件 类 型 . 

不 同 的 资源 类 型 会 有 不 同 的 根 元 素 和 目录 名 , 根 元 素 和 目录 名 会 根据 你 选择 的 文件 类 型 而 变化 . 
XML 文件 的 根 元 素 ,不 同 的 资源 类 型 有 不 同 的 根 元 素 ,在 新 建文 件 以 后 会 自动 生成 . 
例 1: 资 源 类 型 为 Values 的 文件 , 根 元 素 为 resources 

例 2: 资 源 类 型 为 Transition 的 文件 , 根 元 素 为 transitionManager 

Source set: 

编译 时 引用 的 资源 文件 的 来 源 设 置 , 缺 省 的 是 main、debug ` release. 

资源 文件 会 放 在 不 同 的 文件 夹 下 面 ,在 打 不 同 的 包 时 会 引用 不 同 的 资源 . 

Directory name: 


资源 文件 的 目录 名 与 资源 类 型 一 一 对 应 ,不 可 更 改 ,新 建 的 资源 文件 会 自动 放 到 这 个 目录 下 面 ,如 
果 目 录 不 存在 会 自动 创建 . 


Available qualifiers: 
可 用 的 资源 限定 符 ,具体 请 看 《2.17 资源 限定 符 》 


如 果 光 标 放 到 资源 文件 夹 上 : 


示 对 应 的 资源 文件 新 建 先 

点 击 后 也 会 提示 新 建 对 应 的 资源 文件 ,这 样 目标 更 明确 . 

3. 新 建 资 源 文件 目录 : 

新 建 资 源 文件 目录 只 是 新 建 目 录 , 没 有 新 建文 件 的 地 方 .配置 项 里 目录 名 可 以 自 定 义 . 
资源 限定 符 

在 新 建 资源 文件 时 可 以 选择 资源 限定 符 . 


在 Available qualifiers 列 表 中 列 出 了 适 配 时 常用 的 一 些 限定 符 ,选择 限定 符 ,再 进行 相应 的 配置 ， 
就 可 以 在 res 目 录 下 生成 相应 的 资源 文件 夹 . 


Country Code: 

移动 设备 国家 代码 :唯一 识别 移动 用 户 所 属 的 国家 , 共 3 位 ,中 国 为 460; 

移动 设备 网 络 代码 :是 与 Country Code 相 结合 ， 以 用 来 表示 唯一 一 个 的 移动 设备 的 网 络 运营 商 . 
Locale : 


国际 化 (多 语言 ) 如 果 用 户 改 变 了 系统 中 的 语言 设置 ， 那 么 在 应 用 程序 的 运行 期 间 也 能 够 改变 
为 对 应 的 语言 . 


Layout Direction : 

布局 方向 . 

LTR: 从 左 到 右 RTL: 从 右 到 左 

Smallest Screen Width: 

最 小 屏幕 宽度 :这 个 值 是 布局 支持 的 最 小 宽度 ， 而 不 管 屏 幕 的 当前 方向 . 


当 应 用 程序 提供 了 多 个 带 有 不 同 值 的 最 小 宽度 限定 符 资 源 目 录 时 ， 系 统 会 使 用 最 接近 (不 超出 ) 
设备 最 小 宽度 的 那个 资源 . 


Screen Width: 


最 小 的 可 用 屏幕 宽度 ， 当 方向 在 横向 和 纵向 之 间 改 变 时 ， 这 个 配置 值 会 跟 当 前 的 实际 的 宽度 
相 匹配 . 


Screen Height: 


最 小 的 可 用 屏幕 高 度 ， 当 方向 在 横向 和 纵向 之 间 改 变 时 ， 这 个 配置 值 会 跟 当前 的 实际 的 高 度 
相 匹 配 . 


Size: 


屏幕 尺寸 . 

Small: 小 屏幕 尺寸 ,类 似 低 分 辩 率 的 QVGA 屏幕 ,大 约 是 320x426dp; 
Normal: 中 等 屏幕 尺寸 ,类 似 中 等 分 辨认 的 HVGA 屏 幕 ,大 约 是 320x470dp; 
Large: 大 屏幕 尺寸 ,类 似 中 等 分 辨 率 的 VGA 屏 幕 ,大 约 是 480x640dp : 
X-large: 超大 屏幕 尺寸 , 比 HVGA 屏 幕 大 ,大 约 是 720x960dp; 

Ratio: 

宽 高 比率 : 指 的 是 实际 的 物理 尺寸 宽 高 比率 

long: 长 屏幕 nolong: 非 长 屏幕 

Orientation: 

限制 横 坚 屏 切 换 . 

portrait $% ` landscapet® % ` square- © 7 7% 

UI Mode: 

UI 模 式 . 

Car Dock: 车 座 、Desk Dock: 桌 座 、Television: 电 视 上 、Appliance: 装 置 、Watch: 手 表 
当 用 户 将 手机 放 在 不 同 的 Dock 上 或 插入 不 同 的 地 方 ,应 用 程序 在 运行 期 间 就 能 够 改变 这 个 限定 . 
Night Mode: 

夜间 模式 . 

Not Ntight: 白天 

Night: 夜间 

Density: 

密度 : 


指定 不 同 密度 的 手机 使 用 不 同 的 资源 ,如 果 没 有 提供 与 当前 设备 配置 匹配 的 可 选 资源 ， 那 么 系 
统 会 使 用 最 接近 的 资源 . 


Touch Screen: 
Ak RA: 
No Touch: 3} Ak # 


Stylus: 触 控 笔 


Finger: 手指 ( 触 屏 设备 ) 

Keyboard: 

键盘 类 型 . 

Exposed: 设备 有 可 用 的 键盘 ( 硬 或 软 ) 

Hidden: 设备 有 可 用 的 硬 键盘 (被 隐藏 , 且 无 可 用 的 软 键盘 ) 
Soft: 设备 有 可 用 的 软 键盘 (不 管 否 可 见 ) 

Text Input: 

文本 输入 法 

No keys: 设备 没有 用 于 文本 输入 的 硬 键盘 

Qwerty: 设备 有 标准 的 硬 键盘 ,不 管用 户 是 否 可 见 

12 Key: 设备 有 12 个 键 的 硬 键盘 ,不 管用 户 是 否 可 见 . 
Navigation State: 

导航 键 的 状态 . 

Exposed: 导航 键 可 用 

Hidden: 导航 键 不 可 用 

如 果 用 户 能 够 看 到 导航 键 ， 那 么 在 应 用 程序 运行 时 就 能 够 改变 这 个 限定 . 
Navigation Method: 


导航 方法 :None: 除 了 使 用 触 屏 以 外 ,设备 没有 其 他 导航 设施 、D-pad: 设 备 有 用 于 导航 的 定向 
板 、Trackball: 设 备 有 用 于 导航 的 轨迹 球 、 Wheel: 设 备 有 用 于 导航 的 定向 滚轮 


Dimension: 

自 定义 屏幕 尺寸 
Version: 

版 本 . 

设备 支持 的 API 级 别 


创建 AIDL 


什么 是 AIDL ? 


AIDL 是 Android Interface definition language 的 缩写 ， 它 是 一 种 android 内 部 进程 通信 


` 


口 的 描述 语言 ， 通 过 它 我 们 可 以 定义 进程 间 的 通信 接口 


AIDL 可 以 解决 什么 问题 ? 


© 可 以 实现 多 个 应 用 程序 共享 同一 个 Service 的 功能 ， 比 如 : IM 服 务 可 以 提供 给 
用 ， 先 在 推送 基本 都 是 采取 这 种 方案 
o 可 以 跨 进 程 调 用 服务 里 的 方法 


` 


实战 演 


一 


示 


1. 创 建 AIDL 文 件 夹 


@ Pushservice.iava Eà AndroidManifest.xml 
> @ Java Class 
& Android resource file 
Android resource directory 
File 


Package 


Android Eà activity_main.xml @ MainActivity.iava 


app 

manifests 

java 
name.quanke.a 
@ ù MainActiv 
@ ù Pushservi 
name.quanke.a 
name.quanke.a' 


a> 


> 
v 
Copy 

Copy Path 

Copy as Plain Text 
Copy Reference 
Paste 


B 


B C++ Class 
C/C++ Source File 
C/C++ Header File 


= 
res 
drawable 
layout 
= A 
Eà activity_main 
mipmap 


Find Usages 
Find in Path... 
Replace in Path... 
Analyze 


Image Asset 
Vector Asset 


values i) Singleton 


Gradle Scripts Refactor 


Edit File Templates... 
Add to Favorites 


Show Image Thumbnails AIDE 


Activity 
Android Auto 
Folder 
Fragment 
Google 

Other 


Reformat Code 
Optimize Imports 
Delete... 


Run ‘Tests in 'name.quanke.aidldemo... 
Debug ‘Tests in 'name.quanke.aidide 


2.4) ZAIDL X 44 


4% 


多 个 APP 使 


> [) AIDL Folder 
> [i Assets Folder 
> [X JNI Folder 

> [È Java Folder 








mapp 
> E manifests 
v 户 java 


v Lname.quanke.aidldemo 


name. quanke. aidldemo 


PushService Service { 


@ ù MainActivity = Preece 


PushService (c BEVELO EGS 


> 后 name.quanke.=:222 一 ~ } © Android resource file 


> E name.quanke o Ol Android resource directory 


B aidi 


目 File 
Package 


drawable 


layout 


Eà activity mai Copy as Plain Text 


Copy Path C++ Class 
== C/C++ Source File 


mipmap Copy Reference à C/C++ Header File 


values 


Paste 


Gradle Scripts Image Asset 


Find Usages 

Find in Path... 
Replace in Path... M Singleton 
Analyze 


Vector Asset 


Edit File Templates... 


a RAD DAIL File 
> 


Add to Favorites Activity 


3.44 5 AIDL X 44 


// THandler.aidl 
package name. quanke.aidldemo; 


// Declare 


any non-default types here with import statements 


interface IHandler { 
void connect(); 


4.AIDL 文 件 生成 接口 


号 ~ me I~ vz ”一 一 na a . axar: mo 


app Y = a SRA 


main > B ai Make ı ‘nier’ 36F9) EUL CEE on aidldemo IHandler.aidl 
| AainActivityjavi @ PushService.java Eà AndroidManifest.xml 


Ler 


name. quanke. aidldemo; 


IHandler { 
connect(); 


生成 后 的 样子 








J 


activity_main.xml @ MainActivity java @ PushService java Eà AndroidManifest.xml IHandler.aidl @ lHandler java 
AIDLDemo 
> .gradle 
> „idea 
v 四 app 
v build 
v generated 
> assets 


Files under the build folder are generated and should not be edited. 


name. quanke. aidldemo 
android.os.IInterface 


> res android.os.Binder name. quanke. aid|demo. IHandler 
v source : $ 
aidi java, lang.String 
> androidTest 
v [adebug 
了 name.quanke.aidldem 
©@ b IHandler 
> buildConfig @ name. quanke. aidldemo. IHandler (android. os. IBinder obj) 
> r 
> rs ((obj== iM) at 


sattachInterface( 


intermediates } 


outputs android.os.IInterface iin = obj.queryLocalInterface( ) 
tmp (((iin!= )&&(iin name. quanke.aidldemo.IHandler))) { 
libs ((name. quanke. aidldemo.IHandler) iin) 


> src 


B -gitignore 
c app.iml android.os.IBinder () } 
© ( code, android.os.Parcel data, android.os.Parcel reply 


name. quanke. aidldemo. IHandler. Stub. Proxy (obj) 


build.gradle 
E] proguard-rules.pro 
build 

generated 





关于 AIDL 的 使 用 ， 可 以 看 我 的 博客 ， 有 详细 讲解 


http://quanke.name/2016/07/22/Android-Studio-Service-AIDL-%E8%AF%A6%E8%A7%A3/ 


A] @ Android X t+ & 


Æ Android Studio 中 提供 了 新 建文 件 夹 的 功能 ,在 这 里 可 以 新 建 一 些 缺 省 的 文件 夹 . 


a UtanUpdateAgent.java 


com. ut 


androidTest 


main 





第 三 > & 布局 


Android Studio 中 创建 布局 文件 有 两 种 方式 : 在 XML 文本 编辑 器 中 直接 编写 代码 和 使 用 可 视 化 
布局 编辑 器 通过 拖 搜 控件 自动 生成 。 
可 视 化 布局 编辑 器 可 以 通过 拖 搜 控件 生成 布局 ， 可 以 实时 预览 布局 的 效果 。 可 以 在 不 安装 


APP 的 情况 下 ， 随 时 查看 布局 在 不 同 分 辨 兴 、 不 同 版 本 、 不 同 品牌 手机 上 的 显示 效果 ， 节省 
了 大 量 调试 界面 的 时 间 。 


认识 布局 


95 


组 件 列 表 


96 


97 


Widget 组 件 
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ConstraintLayout) & 


1.ConstraintLayout& 4% @ 


更 新 Android Studio 2.2 之 后 ， 更 新 了 布局 设计 器 ， 同 时 ， 引 人 了 ConstraintLayout， 这 一 布 
局 ， 旨 在 降低 布局 层级 ， 其 主要 界面 如 下 所 示 : 


a 
GJ 
a 
a 
用 
一 
. 
a 
m 
= 





这 个 界面 主要 分 成 下 面 几 个 部 分 : 
e 左 侧 边 栏 ， 包 括 Palette 组 件 库 和 Component Tree 
。 中 间 是 布局 设计 器 ， 和 包括 两 部 分 ， 左 边 是 视图 预览 ， 右 边 是 布局 约束 
。 右 侧 边栏 ， 上 面 是 类 似 盒 子 模型 的 边界 和 大 小 布局 设计 器 ， 下 面 是 属性 列表 


在 熟悉 了 界面 之 后 ， 我 们 要 做 的 就 是 理解 ， 什 么 是 ConstraintLayout。ConstraintLayout 的 核 
心 ， 实 际 上 就 是 『 约 束 」， 这 个 翻译 很 直接 ， 也 很 准确 ， 它 可 以 说 是 一 个 强化 的 
RelativeLayout， 只 不 过 比 RelativeLayout 增 加 了 更 多 的 约束 条 件 和 方式 ， 从 这 一 点 上 去 理 
解 ， 就 很 容易 接受 了 。 


在 第 一 次 引 人 ConstraintLayout 的 时 候 ，Android Studio 会 自动 去 下 载 依赖 ， 等 他 自动 完 
成 安装 即 可 。 最 后 ， 在 build.gradle 中 会 添加 一 行 依赖 : 


compile 'com.android.support.constraint:constraint-layout:1.0.0-alphas' 


ConstraintLayout 约 束 


Google 提 供 了 一 个 CodeLab 来 帮助 开发 者 熟悉 这 个 布局 ， 地 址 如 下 所 示 : 

https: VVcodelabs.developers.google.com\Vcodelabs\Vconstraint-layoutVindex.html#0 
同时 ，2016IO 上 Google 也 给 出 了 一 个 Topic 来 讲解 ， 地 址 如 下 所 示 : 

https: VVyoutu.beVsO9axX87hq9c 

2.ConstraintLayout 约 束 类 型 


简单 的 说 ， 约 束 ， 就 是 组 件 与 组 件 之 间 的 关系 ， 借 用 官网 上 的 一 张 图 ， 我 们 来 解释 下 : 


BUTTON1 





这 里 展示 的 ， 就 是 左右 两 个 Button 直 接 的 关系 ， 这 实际 上 就 是 一 个 简单 的 相对 布局 方式 ， 下 面 
我 们 来 看 一 下 具体 的 约束 类 型 。 


当 我 们 点 击 一 个 控件 的 时 候 ， 它 的 显示 效果 如 图 所 示 : 


Q 
O DIITTAM O 





这 里 主要 和 包含 几 种 类 型 的 约束 
e 尺寸 约束 
。 边界 约束 
© 基准 线 约束 
我 们 一 一 来 看 。 


尺寸 约束 


尺寸 约束 使 用 的 是 『 实 心 方块 ]， 如 图 : 





p” 
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ConstraintLayout?) & 


这 个 很 好 理解 ， 就 是 调整 组 件 的 大 小 。 


边界 约束 


边界 约束 使 用 的 是 了 空心 圆圈 」， 如 图 : 





边界 约束 ， 是 使 用 最 多 的 约束 ， 它 用 于 建立 组 件 与 组 件 之 间 、 组 件 与 Parent 边 界 之 间 的 约束 
关系 ， 实 际 上 ， 就 是 确定 彼此 的 相对 位 置 。 


基准 线 约束 


基准 线 约束 ， 使 用 的 是 『 空 心 圆 角 矩形 ]， 如 图 : 


准 线 约束 ， 是 让 两 个 带 有 文本 属性 的 组 件 进行 对 章 的 ， 可 以 让 两 个 组 件 的 文本 按照 基准 线 
行 对 齐 。 唯 一 要 注意 的 是 ， 你 需要 把 鼠标 放 在 控件 上 ， 等 基准 线 约束 的 图 形 亮 了 ， 才 可 以 
进行 拖 动 。 


清除 约束 


通过 工具 栏 上 的 『 了 清除 约束 J 按钮 ， 或 者 是 控件 上 的 悬浮 提示 ， 都 可 以 清除 一 个 控件 的 所 有 
约束 条 件 ， 如 图 : 





掌握 好 这 几 种 约束 条 件 的 使 用 后 ， 就 可 以 自己 去 尝试 下 了 ， 我 们 只 要 拖 一 个 控件 ， 来 体验 
下 o 


3. 约 束 示例 


这 里 我 把 官网 上 的 几 个 Demo 的 动 图 Copy 过 来 : 
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ConstraintLayout4 ® 


Image View 


FE。 
ay 


ImageView 
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ImageView 


TextView1 


TextView TextView 





4.4 #4 Žž Autoconnect 


在 布局 设计 器 的 菜单 栏 上 ， 有 一 个 『 磁 铁 」 一 样 的 图 标 ， 如 图 : 


[H Infer Constraints | 


4c 


®© U; 8 45 


+t 





默认 这 个 按钮 就 是 打开 的 ， 通 过 这 个 ， 我 们 可 以 实现 组 件 约束 的 自动 创建 ，Demo 示 例如 图 : 


ConstraintLayout#) & 





这 个 和 PPT 里 面 拖 动 布局 的 时 候 ， 会 弹出 对 齐 的 基准 线 ， 然 后 帮 你 自动 居中 这 些 功能 类 似 。 
实际 测试 下 来 ， 这 个 功能 可 以 很 方便 的 在 拖 动 组 件 的 时 候 ， 帮 你 写 好 约束 ， 但 有 些 精 确 的 调 
整 ， 还 是 需要 手动 去 创建 的 。 


5. 约 束 推断 Inference 


在 布局 设计 器 的 菜单 上 ， 还 有 一 个 『 灯 泡 4 一 样 的 按钮 ， 通 过 这 个 按钮 ， 可 以 帮 我 们 自动 创 
建 组 件 间 的 约束 关系 ， 他 分 析 的 是 一 个 组 件 附近 的 组 件 ， 并 根据 当前 在 设计 面板 中 的 位 置 来 
创建 约束 关系 ， 如 图 所 示 : 





约束 推断 这 个 功能 非常 强大 ， 我 们 只 需要 把 组 件 拖 到 一 个 地 方 ， 然 后 就 可 以 通过 推断 ， 来 完 
成 最 基本 的 约束 创建 ， 最 后 ， 手 动 进行 完善 即 可 。 
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ConstraintLayout?) # 


AndroidStudioTest 





6.View Inspector 


Inspector 界 面 就 是 设计 布局 的 右边 栏 ， 包 含 了 一 个 


类 似 盒 子 模型 的 布局 检查 器 和 对 应 属性 的 属性 列 
表 ， 如 图 所 示 : 


et_user 


2445] Mar =p 


layout width  @dp 
layout_height wrap_content 
EditText 
inputType textPersonName 
hint UserName 
style 
singleLine 
selectALLOn... 
TextView 
text 

text 
contentDesc... 
wv textAppea... 


fontFami Ly 


typeface 


textSize 
LineSpacing... 
textColor 
textStyle 


textALignment 





属性 这 一 块 我 们 就 不 看 了 ， 和 大 家 在 XML 中 写 的 属性 是 一 样 的 ， 只 不 过 这 里 通过 可 视 化 的 方 
式 弄 出 来 了 ， 这 个 之 前 就 有 了 ， 我 们 主要 来 看 下 上 面 的 那个 界面 。 


Layout_width 


Layout_height 





这 上 面 的 ID， 不 多 说 了 ， 这 个 盒子 四 周 的 线 ， 代 表 着 我 们 的 Margin 设 置 ， 在 工具 栏 上 ， 还 可 
以 设置 Margin 的 基数 ， 对 于 MD 设计 风格 ， 这 个 基数 一 般 是 8dp， 所 以 ， 这 里 可 以 选择 X8 的 
Margin : 





另外 ， 最 外 面 边框 上 还 有 两 个 带 数 字 的 小 圆圈 ， 这 个 就 是 控制 相对 位 置 的 比例 的 ， 如 图 : 


Onnotraint ALVIN tvh pb 
ConstraintLayout 约 采 


AndroiaStudioTest 


ll 


一 一 FS 


l 


这 里 的 四 根 线 ， 在 点 击 后 ， 会 发 生变 化 ， 总 共有 以 下 几 种 : 


Fixed 

H 

这 样 一 个 类 型 的 线 ， 可 以 让 你 写 定 具体 的 大 小 数值 。 
Wrap Content 

>>> 

这 个 就 是 Wrap Content 的 含义 ， 包 庄内 容 ， 没 有 发 生变 化 。 
AnySize 


MH 





ConstraintLayout?) # 


这 个 就 是 最 难 理解 的 ， 它 表示 组 件 会 占用 所 有 的 可 用 空间 来 适应 约束 ， 类 似 线性 布局 中 ， 设 
置 width=0，weight=1 的 方式 。 


7.Align 





在 工具 栏 中 ， 可 以 使 用 对 齐 工具 ， 快 速 给 选 定 组 件 设置 对 齐 约束 ， 如 图 : 


我 们 可 以 来 演示 下 : 


AndroidStudioTest 





8.Pack 


在 工具 栏 中 ’ 可 以 使 用 Pack 工 具 9 快速 对 组 件 进行 编组 操作 如 图 8 


ConstraintLayout#) 


AndroidStudioTest 





9. 快 捷 布 局 


在 一 个 组 件 上 点 击 右键 ， 可 以 快速 创建 一 些 布 局 的 
快捷 设计 ， 如 图 所 示 : 


在 这 里 ， 可 以 快速 设置 组 件 的 居中 ， 对 齐 等 方式 。 


istraintLayoutZ x 


AndroidStudioTest 
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QuserNa 
ae 


walt Expand Horizontally 
[7] Expand Vertically 


«— Passwd 


Center Horizontally 
Center Vertically 
"|" Center Horizontally in Parent 
pha 3 


| 


enter Vertically in Parent 
Constraint Layout 
= Add Vertical Guideline 


| Add Horizontal Guideline 





10.GuideLine 


为 了 更 加 灵活 的 布局 ，ConstraintLayout 还 提供 了 一 个 GuideLine， 如 图 所 示 : 


Add Vertical Guideline 


|Add Horizontal Guideline 





你 可 以 为 布局 添加 水 平和 竖 直 引导 线 ， 针 对 这 条 线 来 作为 基准 线 布局 ， 如 图 所 示 : 


ConstraintLayout 约 束 





11.ConstraintLayout 布 局 转换 


通过 Android Studio， 我 们 可 以 很 方便 的 把 一 个 普通 布局 转化 为 ConstraintLayout ， 在 布局 设 
计 器 的 左边 栏 下 面 的 Component Tree 来 进行 转换 ， 如 图 所 示 : 
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Component Tree 
了 国 Linearl 
or butt 
GS text 





LinearLayout 


Select 


Copy 


Delete 


Go to XML 


Refactor 


J Save Screenshot... 


Convert LinearLayout to ConstraintLayout 


转换 还 是 很 赞 的 ， 但 目前 还 没 试 过 复杂 的 布局 是 否 有 问题 。 


12. 从 代码 角度 理解 ConstraintLayout 属 性 


ConstraintLayout 被 称 为 增强 的 RelativeLayout， 是 有 它 的 原因 的 ， 相 对 布局 提供 了 
layout_toBottomOf 类 似 这 样 的 属性 来 控制 组 件 间 的 相对 位 置 ， 那 么 ConstraintLayout 实 际 上 也 
是 一 样 的， 我 们 来 看 这 样 一 个 属性 : 


app:layout_constraintTop_toBottomOf 


他 代表 的 是 『 期 望 组 件 的 顶部 ， 与 指定 组 件 的 底部 对 齐 」， 那 么 了 解 了 这 个 解释 方式 ， 其 它 
的 属性 就 很 好 理解 了 ， 所 以 说 ， 虽 然 ConstraintLayout 不 太 建 议 通 过 代码 来 布局 了 ， 但 能 理解 
代码 的 含义 ， 对 理解 ConstraintLayout 布 局 是 非常 有 帮助 的 。 


项 目 窗口 
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类 结构 
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捕获 界面 
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文件 管理 
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切换 文件 编码 
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文件 同步 
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Lees 
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TODO 


未 完成 的 任务 或 者 是 需要 解决 的 bug， 都 可 以 使 用 TODO 来 标识 ， 用 来 提醒 团队 成 员 需 要 注意 
这 些 地 方 ，Android Studio 对 TODO 提供 了 非常 好 的 支持 ， 建 议 掌 握 此 工具 。 


增加 TODO 


增加 TODO 只 需要 在 注释 中 添加 TODO 关键 字 就 可 以 了 。 


有 一 种 比较 方便 的 方法 就 是 ， 直 接 在 代码 里 输入 小 写 的 todo,Android Studio 会 自动 生成 
注释 并 且 加 上 日 期 ， 类 似 “WW/ TODO: 2016V9V16” 


操作 步骤 : 
添加 注释 一 > 输入 TODO 一 > 添加 说 明 


Java ` xml ` gradle 文件 都 支持 TODO 


查看 TODO 侍 务 
TODO 工 具 窗口 中 查看 TODO 任 务 


操作 步骤 : 


菜单 栏 一 > View 一 > TODO 


TODO 间 上 下 跳 转 


光标 定位 在 某 个 TODO 任 务 上 ,可 以 使 用 快捷 键 快 速 上 下 跳 转 来 查看 


快捷 键 : 
Mac: Alt + Command + 向 上 箭头 和 Alt+ Command + 向 下 箭头 


WindowsVLinux: Ctrl + Alt + 向 上 箭头 和 Ctrl+Alt+ 向 下 箭头 


设置 TODO 


设置 TODO 有 界面 可 以 从 偏好 设置 中 打开 ,也 可 以 从 TODO 工 具 窗 口 打开 .虽然 路 径 不 同 ,但 设置 项 
是 相同 的 . 我 们 下 面 均 以 偏好 设置 中 的 设置 为 例 进 行 讲 解 . 


设置 TODO 关 键 字 匹 配 区 分 大 小 写 


默认 TODO 关 键 字 匹配 是 不 区 分 大 小 写 的 ,因此 不 管 是 TODO 还 是 todo 都 被 识别 为 TODO 任 务 ， 
如 果 想 要 区 分 大 小 写 ， 需 要 设置 。 


操作 步 又: 
Preferences 一 > Editor 一 > TODO 一 > 在 需要 区 分 大 小 写 的 匹配 前 面色 选 Case Sensitive 。 


4) % Case Sensitive 之 后 确定 设置 .。 再 查看 之 前 的 todo 就 不 会 被 识别 为 TODO 任 务 了 。 


自 定 义 TODO 关 键 字 
如 果 想 要 通过 TODO 来 分 配 任务 , 使 用 自 定义 关键 字 会 更 加 方便 管理 。 


比如 : todo-quanke 是 分 配给 我 自己 的 任务 ,todo-zhiran 是 分 配给 志 然 的 任务 。 


操作 步 又: 


Preferences 一 > Editor 一 > TODO 一 > 添加 按钮 一 > 输入 匹配 表达 式 一 > 选择 icon 一 > 设置 
颜色 


Build Variants (构建 变种 版 本 ) 
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第 五 草 编辑 


以 让 这 些 操作 变 得 简 


4% l% 
P 
a 


复制 /粘贴 / 剪 切 /撤销 / 重 做 


复制 
菜单 栏 : Edit —> Copy 


快捷 键 : 


Mac: Command + C 


Windows/Linux: Ctrl + C 


复制 为 纯 文 本 

IRAE DR: 

菜单 栏 一 > Edit 一 > Copy as Plain Text 
复制 引用 

IRAE DR: 

菜单 栏 一 > Edit 一 > Copy Reference 


快捷 键 : 
Mac: Alt + Command + Shift + C 


Windows/Linux: Ctrl + Alt + Shift + C 
= Pin 

复制 行 

快速 复制 一 行内 容 


操作 步骤 : 


菜单 栏 : Edit 一 > Duplicate Line 


快捷 键 : 


Mac: Command + D 


Windows/Linux: Ctrl + D 


粘贴 
菜单 栏 : Edit 一 > Paste 


快捷 键 : 


Mac: Command + V 


Windows/Linux: Ctrl + V 


从 复制 历史 中 选择 粘贴 


操作 步骤 : 


菜单 栏 一 > Edit 一 > Paste from History 


设置 粘贴 历史 记录 的 个 数 


Android Studio 黑 认 人 允许 记录 5 个 粘贴 历史 , 但 这 个 是 可 以 设置 的 ， 如 果 你 想 调整 粘贴 历史 记 
录 ， 可 以 这 样 设置 . 


操作 步 又: 


Preferences 一 > Editor 一 > 点 击 General 一 > 在 Limits 中 调整 Maximum number of contents to 
keep in clipboard 的 个 数 


yz 
S 


菜单 栏 : Edit 一 > Cut 


快捷 键 : 


Mac: Command + X 


Windows/Linux: Ctrl + X 


撤消 : 
菜单 栏 : Edit 一 > Undo 


快捷 键 : 


Mac: Command + Z 


Windows/Linux: Ctrl + Z 


重 做 
菜单 栏 : Edit 一 > Redo 


快捷 键 : 


Mac: Shift + Command + Z 


Windows/Linux: Ctrl + Shift + Z 


查找 替换 
查找 工具 栏 


快捷 键 


Mac: Command + F 


Windows\V/Linux: Ctrl + F 


快速 查找 


先 选 中 复制 ,然后 调 出 查找 工具 栏 ,选中 部 分 就 被 自动 填 入 搜索 框 ， 按 回 车 键 快速 搜索 。 


操作 步骤 〈 快 捷 键 ) : 
Command + C (复制 单词 ) 
Command + F ( 调 出 查找 工具 栏 ) 


Enter ( 回 车 开始 查找 ) 


在 查找 结果 中 跳 转 
下 一 个 匹配 到 的 结果 


快捷 键 : 


Mac: Command + G 
WindowsVLinux: F3 


上 一 个 匹配 到 的 结果 


快捷 键 : 
Mac: Command + Shift + G 


WindowsVLinux: Shift + F3 


在 匹配 到 的 相同 的 结果 间 跳 转 
快捷 键 : 


MacVWindowsVLinux: Enter 
选择 查找 结果 


同时 选中 所 有 查找 到 的 结果 


菜单 栏 : Edit 一 > Find 一 > Select All Occurrences 


快捷 键 : 
Mac: control + Command + G 


WindowsVLinux: Ctrl + Alt + Shift + J 

s +t, x “2 Za i 
连续 选择 当前 及 下 一 个 结果 
操作 步骤 : 

菜单 栏 : Edit 一 > Find 一 > Add Select for Next Occurrence 


快捷 键 : 
Mac: control + G 


WindowsVLinux : Alt + J 


—— 4 Bi iF 
操作 步骤 : 


菜单 栏 : Edit 一 > Find 一 > UnSelect Occurrence 


快捷 键 : 


Mac: control + Shift + G 


Windows\V/Linux : Alt + Shift + J 


指定 查找 路 径 
操作 步 刀 
菜单 栏 : Edit 一 > Find 一 > Find in Path... 


快捷 键 : 


Mac: Shift + Command + F 


Windows\V/Linux: Ctrl + Shift + F 


替换 
操作 步骤 
菜单 栏 : Edit 一 > Find 一 > Replace 


快捷 键 : 


Mac: Command + R 


Windows\V/Linux: Ctrl + R 


指定 AR 换 路 径 
操作 步骤 
菜单 栏 : Edit 一 > Find 一 > Replace 


快捷 键 : 
Mac: Command + Shift + R 


Windows\VLinux: Ctrl + Shift + R 


指定 查找 范围 : 


操作 步骤 : 
点 击 Find 一 > 弹出 确认 对 话 框 
默认 点 击 Replace 是 一 个 一 个 替换 的 ,你 也 可 以 有 其 它 选 择 : 
e 点 击 Skip 会 跳 过 当前 匹配 结果 
e 点 击 Replace All in This File 会 替换 当前 文件 中 所 有 的 匹配 结果 
e 点 击 Skip To Next File 会 跳 到 下 一 个 文件 
。 点 击 All Files 就 全 部 替换 啦 
e 点 击 Review, 在 工具 栏 显示 查找 结果 ,点 击 后 可 以 查看 详情 . 


Replace Selected 替 换 选 匹配 项 ,Replace All 全 部 替换 . 


查找 替换 历史 : 


Android Studio 会 记录 你 所 有 的 查找 和 替换 的 历史 和 配置 , 当 你 再 一 次 进行 查找 的 时 候 默 认 是 使 
用 上 一 次 的 替换 记录 


在 结构 中 搜索 和 和 替换 


操作 步 又: 


菜单 栏 : Edit 一 > Find 一 > Search StructurallyVReplace Structurally 一 > 打开 [ Search 
Structurally ] 


查找 用 法 
看 某 个 方法 或 变量 在 哪些 地 方 使 用 
操作 步骤 : 


菜单 栏 : Edit 一 > Find 一 > Find Usages 


右键 菜单 : Find Usages 


快捷 键 : 
Mac: fn + option + F7 


WindowsVLinux: Alt + F7 

设置 查找 用 法 的 过 程 和 气 
操作 步 又: 

菜单 栏 : Edit 一 > Find 一 > Find Usages Settings 


快捷 键 : 


Mac: option + Command + Shift + F7 


WindowsVLinux: Ctrl + Alt + Shift + F7 


大 小 写 替换 
操作 步骤 : 
菜单 栏 : Edit 一 > Toggle Case 


快捷 键 : 


Mac: Shift + Command + U 


Windows/Linux: Ctrl + Shift + U 


Macros (% ) 


HARE? 


是 一 种 批量 批 处 理 的 称谓 , 它 是 一 些 命令 组 织 在 一 起 ， 作 为 一 个 单独 命令 完成 一 个 特定 任务 。 


x 


录制 回放 宏 
ER: 自动 保存 代码 ,然后 运行 代码 


第 一 步 : Edit --> Macros --> Start Macros Recording --> Android Studio 右 下 角 显 示 开 始 录制 


第 二 步 : 按 下 command +s 保存 文件 

第 三 步 : 按 下 control + s 运行 代码 

第 四 步 : Edit --> Macros --> Stop Macros Recording --> 指出 输入 框 ,输入 已 录制 的 宏 的 名 字 
第 五 步 : 定义 快捷 键 


Android Studio --> Keymap -- Macros -- 找到 我 们 刚才 录制 的 宏 [AutoSaveAndRun] 


编辑 宏 


Edit --> Macros --> Edit Macros 


使 用 列 选择 模式 
操作 步骤 


菜单 栏 一 > Edit -- > Column Selection Mode ( 列 选择 模式 ) 


快捷 键 : 


Mac: Shift + Command + 8 


Windows/Linux: Alt + Shift + Insert 


扩大 /缩小 选择 范围 
执行 一 次 扩大 选择 ,选择 范围 就 会 相应 的 扩大 
操作 步骤 

菜单 栏 : Edit --> Extend Selection 


快捷 键 : 


Mac: option + 1 


Windows/Linux: Ctrl + W 


缩小 选择 范围 与 上 面 的 扩大 选择 相反 
操作 步骤 
菜单 栏 : Edit --> Shrink Selection 


快捷 键 : 
Mac: option + | 


Windows/Linux: Ctrl + Shift + W 


` 一 <a 
合并 两 行内 容 
可 以 智能 的 合并 字符 串 、 注 释 、 声 明和 赋值 
操作 步骤 : 
菜单 栏 : Edit 一 > Join Lines (合并 行 ) 


快捷 键 : 


Mac: control + shift + j 


Windows/Linux: Ctrl + Shift + J 


Aah th A 4 ay 0972 4 


自动 补 全 当前 的 语句 可 以 帮 你 完成 正在 输入 的 语 名 的 剩余 部 分 ， 自 动 增加 漏 掉 的 大 括号 小 括 
号 和 必要 的 格式 化 处 理 。 


操作 步骤 : 
菜单 栏 : Edit 一 > Complete Current Statement (自动 补 全 当前 的 语句 ) 


快捷 键 : 


Mac: shift + command + 回 车 Windows/Linux: Ctrl + Shift + © 


Ha BF 
操作 步骤 : 
菜单 栏 : Edit 一 > Indent Selection (必须 选中 行 ) 


快捷 键 : 


Mac/Windows/Linux: Tab 


菜单 栏 : Edit 一 > Unlndent Line or Selection 


快捷 键 : 


Mac/Windows/Linux: Shift + Tab 


切换 大 小 写字 母 
操作 步骤 : 
菜单 栏 : Edit 一 > Toggle Case 


快捷 键 : 


Mac: Shift + Command + U 


Windows/Linux: Ctrl + Shift + U 
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查看 方法 的 参数 
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查看 表达 式 的 类 型 
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查看 源码 
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150 


近 的 改动 


opt 
Kal 


看 
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对 比 任意 文件 
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快速 切换 视图 模式 
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快速 切换 全 屏 
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使 用 演示 模式 
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使 用 全 屏 模式 
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使 用 免 打 扰 模 式 
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工具 窗口 间 快 速 切 换 
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IDE 里 的 导航 就 是 ， 在 各 个 类 、 文 件 、 方 法 中 快速 跳 转 ， 熟 悉 运 用 导航 快捷 键 ， 可 以 大 大 提高 
工作 效率 


搜索 并 打开 东 个 类 文件 


如 果 需 要 搜索 类 名 ， 需 要 知道 类 的 名 字 ， 可 以 支持 模糊 匹配 


操作 步骤 : 


菜单 栏 : Navigate-->Class 


快捷 键 : 


Mac: Command + O 
Windows\V/Linux: Ctrl + N 


精确 跳 转 到 类 文件 的 某 一 行 


精确 跳 转 到 类 文件 的 某 一 行 
和 搜索 某 一 个 类 文件 一 样 ， 只 是 在 后 面 加 上 :和 行 号 


例如 : EmptyLayout:50 


搜索 并 打开 某 个 文件 


如 果 需 要 搜索 某 个 文件 ， 需 要 知道 文件 的 名 字 ， 可 以 支持 模糊 匹配 
操作 步骤 : 
菜单 栏 : Navigate-->File 


快捷 键 : 


Mac: Shift + Command + O 


Windows\V/Linux: Ctrl + Shift + N 


搜索 并 打开 茶 个 文件 或 方法 
此 方法 支持 文件 和 方法 搜索 

操作 步骤 : 

菜单 栏 : Navigate-->Symbol 


快捷 键 : 


Mac: Option + Command + O 


Windows\V/Linux: Ctrl + Alt + Shift + N 


菜单 栏 : Navigate --> Line 


快捷 键 : 


Mac: Command + L 


Windows\V/Linux: Ctrl + G 


使 用 上 自 定 义 代码 块 
在 代码 片段 的 开始 和 结束 加 上 表示 ， 有 了 这 个 表示 以 后 ， 就 可 以 展开 和 折 重 
自 定义 代码 库 如 下 所 示 


//<editor-fold desc="Description"> 


findViewById(R.id.btnLoading).setOnClickListener(new View.OnClickListener() { 


@Override 

public void onClick(View view) { 
emptyLayout .showLoading(); 

Ht); 


findViewById(R.id.btnEmpty) .setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View view) { 
emptyLayout.showEmpty(); 
3h); 


//</editor-fold> 


快捷 键 : 


WindowsVLinux: Ctrl + Shift + T 2 & 24% `<editor-fold...> ` 


在 自 定 义 代 码 块 之 间 选 择 和 跳 转 
操作 步骤 : 
菜单 栏 : Navigate --> Custom Folding 


快捷 键 : 


Mac: Option + Command + . 
Windows\VLinux: Ctrl + Alt + . 


注意 : 不 要 使 用 小 写 键盘 的 . 


快速 跳 转 到 光标 的 历史 位 置 


快速 跳 转 到 光标 上 一 个 历史 位 置 
操作 步 又: 
菜单 栏 : Navigate 一 > Back 


快捷 键 : 
Mac: Command + [ 


Windows\V/Linux: Ctrl + Alt + — 


快速 跳 转 到 光标 下 一 个 历史 位 置 
操作 步 又: 
菜单 栏 : Navigate 一 > Forward 


快捷 键 : 


Mac: Command + [ 


Windows\V/Linux: Ctrl + Alt + 一 


快速 跳 转 到 编辑 过 的 位 置 


光标 快速 跳 转 到 上 一 个 编辑 过 的 位 置 
IRAE DR: 
菜单 栏 : Navigate 一 > Last Edit Location 


快捷 键 : 


Mac: Shift + Command + delete 


WindowsVLinux': Ctrl + Shift + Backspace 


光标 快速 跳 转 到 下 一 个 编辑 过 的 位 置 
操作 步骤 : 
菜单 栏 : Navigate 一 > Next Edit Location 


快捷 键 : 


Mac: 


WindowsVLinux: 


标记 书签 


Android Studio 书签 是 什么 ? 


在 Android Studio 中 的 书签 是 指 对 代码 的 标记 ， 标 记 我 们 阅读 的 位 置 .。 给 代码 加 上 书签 , 就 可 
以 快速 的 在 不 同 的 书签 中 切换 。 


一、 > 5k 
imie PA 

前 提 条 件 : 

光标 放 到 需要 标记 的 位 置 

LEVEE th TR : 

菜单 栏 : Navigate 一 > Bookmarks 一 > Toggle Bookmark 
快捷 键 : 


Mac: Fn + F3 


WindowsVLinux: F11 


第 1 步 : 把 光标 定位 在 需要 加 书签 的 那 一 行 代码 
第 2 步 : 快捷 键 (Mac): Fn + F3 
结果 : 这 行 代码 就 会 打上 了 标签 


取消 书签 和 标记 书签 操作 时 一 样 的 
使 用 助 记 符 标 书签 
使 用 一 个 符号 帮助 我 们 记忆 


前 提 条 件 : 


光标 放 到 需要 标记 的 位 置 


操作 步骤 : 
菜单 栏 : Navigate 一 > Bookmarks 一 > Toggle Bookmark with Mnemonic 


快捷 键 : 


Mac: Fn + Option + F3 


Windows\V/Linux: Ctrl + F11 


第 1 步 : 把 光标 定位 在 想 加 书签 的 那 一 行 代码 

第 2 步 : 快捷 键 (Mac): Fn + Opetion + F3 

第 3 步 : 在 弹出 的 Bookmark Mnemonic 弹 窗 中 选择 助 记 符 , 助 记 符 为 一 个 数字 和 字母 
第 4 步 : 然后 在 编辑 器 的 左边 栏 就 会 显示 助 记 符 书 签 

把 光标 放 到 助 记 符 书签 上 ,会 提示 你 这 是 一 个 书签 ， 


取消 书签 和 标记 书签 操作 时 一 样 的 


对 书签 进行 搜索 、 排 序 、 修 改 描 述 、 删 除 、 查 看 等 操作 


打开 书签 管理 界面 


操作 步 又: 


菜单 栏 : Navigate 一 > Bookmarks 一 > Show Bookmarks 


快捷 键 : 


Mac: Fn + Command + F3 


WindowsVLinux: Shift + F11 


修改 书签 描述 


在 书签 管理 界面 点 击 左上 角 的 编辑 按钮 一 > 在 弹 窗 中 输入 描述 


快捷 键 : 


Mac: Command + 回 车 一 > 在 弹 窗 中 输入 描述 


= 


Windows\VLinux: Ctrl + 回 车 一 > 在 弹 窗 中 输入 描述 
在 收藏 夹 中 管理 书签 


操作 步骤 : 


工具 栏 一 > Favorites 一 >Bookmarks 


快捷 键 : 
Mac: Alt + 2 --> 选择 Bookmarks 


Windows\VLinux: Alt + 2 --> 选择 Bookmarks 


快速 跳 转 到 导航 栏 
写 代码 的 时 候 想 快速 跳 转 到 导航 栏 ,在 导航 栏 进行 文件 切换 时 使 用 


操作 步骤 : 


菜单 栏 : Navigate 一 > Jump to Navigation Bar 


快捷 键 : 


Mac: Command + + 


Windows\/Linux: Alt + Home 


> alr + 
快速 跳 转 到 声明 
在 写 代码 或 阅读 代码 时 ,如 果 需 要 查看 一 个 引用 首次 被 声明 的 位 置 ,可 以 使 用 此 功能 . 
你 可 以 在 代码 中 的 任何 位 置 查 看 一 个 引用 首次 被 声明 的 位 置 . 
此 功能 使 用 频率 非常 高 ， 建 议 熟 练 掌握 
操作 步 又: 


菜单 栏 : Navigate 一 > Declaration 


快捷 键 : 


Mac: Command + B 


Windows\/Linux: Ctrl + B 


鼠标 : 
Mac: 按 住 Command 键 一 > 点 击 类 、 变 量 或 方法 


WindowsVLinux: 按 住 Ctrl #@ 一 > 点 击 类 、 变 量 或 方法 


快速 查看 茶 个 引用 的 类 型 声明 


菜单 栏 : Navigate 一 > Type Declaration 


快捷 键 : 


Mac: Shift + Command + B 


Windows\V/Linux: Ctrl + Shift + B 


鼠标 : 
Mac: 按 住 Command+Shift 键 一 > 点 击 类 、 变 量 或 方法 


Windows\Linux: 按 住 Ctrl +Shift 键 一 > 点 击 类 、 变 量 或 方法 


快速 跳 转 到 实现 

查看 某 个 接口 在 哪里 被 实现 

操作 步骤 : 

菜单 栏 : Navigate 一 > Implementation 


快捷 键 : 


Mac: Option + Command + B 


Windows\V/Linux: Ctrl + Alt + B 


快速 跳 转 到 父 类 

查看 某 个 子 类 的 父 类 或 者 快捷 跳 转 到 父 类 
前 提 条 件 : 

光标 定位 在 方法 体内 或 类 名 上 . 

操作 步骤 : 

菜单 栏 : Navigate 一 > Super Method 


快捷 键 : 


Mac: Command + U 


WindowsVLinux: Ctrl + U 


在 快速 类 和 被 测试 类 之 间 快 速 跳 转 


相对 来 说 使 用 频率 不 高 ， 暂 时 不 编写 ， 以 后 加 上 


查看 相关 联 的 文件 


比如 Activity 绑 定 了 xml， 可 以 使 用 此 功能 快速 跳 转 到 绑 定 的 Xml 


操作 步骤 : 
菜单 栏 : Navigate 一 > Related Symbol 


快捷 键 : 


Mac: control + command + 1 


Windows\/Linux: Ctrl + Alt + Home 


查看 文件 结构 


快速 调 出 当前 文件 的 结构 ， 并 通过 模糊 匹配 快速 跳 转 至 指定 的 方法 


此 功能 很 实用 ， 建 议 熟练 掌握 


操作 步 又: 


菜单 栏 : Navigate 一 > File Structure 


快捷 键 : 


Mac: Fn + Command + F12 


Windows\V/Linux: Ctrl + F12 


显示 匿名 内 部 类 

4] % Show Anonymous Classes 
显示 所 有 继承 的 方法 
名 选 Show inherited members 


输入 时 缩小 


匀 先 输入 时 缩小 (Narrow down on tying) : 搜索 结果 会 自动 过 滤 , 不 匹配 的 不 会 展示 


不 匀 先 输入 时 缩小 (Narrow down on tying): 不 匹配 的 项 是 不 会 被 过 滤 掉 ， 会 展示 


菜单 栏 : Navigate —>Type Hierarchy 


快捷 键 : 


Mac: control + H 


Windows\V/Linux: Ctrl + H 


查看 方法 类 型 的 层次 结构 图 


查看 某 个 方法 在 哪个 类 中 定义 ,在 哪些 类 中 实现 
IRAE D R: 
菜单 栏 : Navigate 一 > Method Hierarchy 


快捷 键 : 


Mac: Shift + Command + H 


Windows\V/Linux: Ctrl + Shift + H 


菜单 栏 : Navigate 一 > Call Hierarchy 


快捷 键 : 


Mac: control + option + H 


Windows\/Linux: Ctrl + Alt + H 


快速 跳 转 到 错误 代码 位 置 


代码 如 果 出 现 错误 ,编辑 器 会 在 右边 栏 高 亮 显 示 红 色 的 条 标 , 如 果 有 多 处 错误 就 会 显示 多 个 


如 果 想 快捷 查看 错误 代码 ,可 以 通 右边 栏 的 条 标 进 行 快速 跳 转 。 


跳 转 到 下 一 个 错误 位 
操作 步骤 
菜单 栏 : Navigate 一 > Next Highlighted Error 


快捷 键 : 


Mac: Fn + F2 


WindowsVLinux: F2 


跳 转 到 上 一 个 错误 位 置 
操作 步骤 
菜单 栏 : Navigate 一 > Previous Highlighted Error 


快捷 键 : 


Mac: Fn + Shift + F2 


WindowsVLinux: Shift + F2 


条 标 . 


方法 间 前 后 跳 转 

跳 转 到 下 一 个 方法 

操作 步 又: 

菜单 栏 : Navigate 一 > Next Method( 下 一 个 方法 ) 
快捷 键 : 


Mac: control + 1 (此 快捷 键 与 可 能 与 系统 快捷 键 冲突 ,请 自行 修改 ) 


WindowsVLinux: Alt + + 

跳 转 到 上 一 个 方法 

操作 步 又: 

菜单 栏 : Navigate 一 > Previous Method( 上 一 个 方法 ) 


快捷 键 : 
Mac: control + | (此 快捷 键 与 可 能 与 系统 快捷 键 冲 突 ,请 自行 修改 ) 


WindowsVLinux: Alt + | 


使 用 翻 页 


向 上 翻 页 : 
快捷 键 : 


Mac: Fn+t 


Windows\/Linux:PgUp 


向 下 翻 页 : 
快捷 键 : 


Mac: Fn+ | 


Windows\/Linux:PgDn 


选择 当前 文件 在 哪里 显示 
操作 步 又: 
菜单 栏 : Navigate 一 > Select in 


快捷 键 : 


Mac: Fn + Option + F1 


Windows\/Linux: Alt + F1 


光标 快速 跳 转 到 编辑 器 


如 果 编 辑 器 处 于 活跃 状态 (文件 处 于 打开 状态 ), 当 焦点 不 在 编辑 器 时 , 按 下 ESC 键 可 以 让 焦点 从 
任何 其 他 工具 窗口 返回 到 活跃 的 编辑 器 . 


按 下 ESC 键 仅 光 标 跳 转 到 编辑 器 , Shift + ESC 关闭 工具 窗口 后 再 跳 转 到 编辑 器 。 


第 八 章 编码 


Android Studio 中 提供 的 代码 生成 、 活 动 模板 、 自 动 补 全 和 格式 化 代码 的 功能 ， 能 够 帮助 我 们 
极 大 的 提高 的 编码 效率 。 


复写 或 者 实现 方法 


履 写 父 类 的 方法 或 实现 接口 方法 


菜单 栏 : Code 一 > Override Method 


快捷 键 : 


Mac: control + O 


Windows\/Linux: Ctrl + O 


实现 接口 方法 


Override Method 可 以 实现 接口 方法 也 可 以 履 写 父 类 的 方法 ， 但 Implement Methods 只 能 实现 
接口 方法 


操作 步骤 : 
菜单 栏 : Code 一 > Implement Methods 


快捷 键 : 


Mac: control + 上 


WindowsVLinux: Ctrl + | 


实现 代理 方法 


生成 构造 函数 
操作 步 又: 


菜单 栏 : Code 一 > Generate 一 > Constructor 


快捷 键 : 


Mac: command + N 


Windows\/Linux: Alt + Insert 一 > Constructor 


生成 Getter 和 Setter 方 法 


操作 步骤 : 


菜单 栏 : Code 一 > Generate 一 > Getter and Setter 


快捷 键 : 


Mac: command + N 


Windows\/Linux: Alt + Insert 一 > Getter and Setter 


#5 equals#-hashcode 7 x 


操作 步骤 : 


菜单 栏 : Code 一 > Generate 一 > equals() and hashCode() 


右键 菜单 :Generate 一 > equals() and hashCode() 


快捷 键 : 


Mac: command + N 


Windows\VLinux: Alt + Insert 一 > equals() and hashCode() 


Rik A 5 toString 7 > 


操作 步骤 : 
菜单 栏 : Code 一 > Generate 一 > toString() 


右键 菜单 : Generate 一 > toString() 


快捷 键 : 


Mac: command + N 


Windows\Linux: Alt + Insert 一 > toString() 


插入 版 权 信 息 
操作 步骤 


菜单 栏 : Code 一 > Generate 一 > Copyright 


右键 菜单 : Generate 一 > Copyright 


快捷 键 : 


Mac: command + N 
Windows\Linux: Alt + Insert 一 > Copyright 


如 果 你 当前 没有 定义 任何 Copyright 信 息 ,会 提示 设置 版 权 信 息 ， 点 击 OK， 进 去 版 权 信息 
配置 


日 N ` 
提取 或 删除 语句 
从 for, foreach, if..elseif...else, try...catch...finally, while...do, do...while 中 快速 提取 或 删除 代码 
提取 或 删除 代码 的 时 候 ,被 绿色 选中 的 是 要 提取 的 内 容 ,被 红色 选中 的 是 要 被 删除 的 内 容 ， 
操作 步 又: 
菜单 栏 : Code 一 > UnwrapVRemove 


快捷 键 : 


Mac: command + shift + Delete 


Windows\/Linux: Ctrl + Shift + Delete 


智能 自动 补 全 会 将 不 适用 的 条 目 过 滤 掉 ， 只 显示 可 用 的 类 、 变 量 、 属 性 或 者 方法 
操作 步骤 : 
菜单 栏 :Code 一 > Completion 一 >SmartType 


快捷 键 : 


Mac: control + Shift + 空格 


WindowsVLinux: Ctrl + Shift + 空格 


代码 补 全 


当 弹 出 代码 补 全 提示 时 ,可 以 和 鼠标 |EnterlTab|IV.|; 进 行 补 全 ,但 这 几 种 补 全 方法 功能 是 不 一 样 
的 。 


补 全 后 不 会 删除 后 面 的 代码 


操作 步骤 : 


弹出 代码 补 全 提示 一 > 光标 选中 补 全 代码 一 > 鼠标 VEnter 


补 全 后 删除 后 面 的 代码 
操作 步骤 

弹出 代码 补 全 提示 一 > 光标 选中 补 全 代码 一 >Tab 
布尔 值 取 反 补 全 

操作 步骤 


弹出 布尔 值 代码 补 全 提示 一 > 光标 选中 补 全 代码 (是 弹出 代码 提示 时 候 的 选择 ) 一 > 叹 号 (!) 


循环 扩展 词 


FRA RA BRAS 


RAAI BRAG 
操作 步骤 : 
菜单 栏 :Code 一 > Folding 一 > Expand 


快捷 键 : 


Mac: command + “+” 


Windows\VLinux: Ctrl + "+" 


H ARI BAG 
操作 步骤 : 
菜单 栏 :Code 一 > Folding 一 > Collapse 


快捷 键 : 


Mac: command + “-” 


Windows\/Linux: Ctrl + "-" 


KAKA E KATARE k F gA FAR IR 
操作 步骤 : 
菜单 栏 :Code 一 > Folding 一 > Expand Recursively 


快捷 键 : 


Mac: option + command + “+” 


Windows\VLinux: Ctrl + Alt + "+" 


折 司 当前 代码 块 中 的 所 有 子 模块 


操作 步 又: 

菜单 栏 :Code 一 > Folding 一 > Collapse Recursively 
快捷 键 : 

Mac: option + command + “-” 


Windows\/Linux: Ctrl + Alt + NumPad + "-" 


展开 全 部 代码 块 


操作 步骤 : 

菜单 栏 :Code 一 > Folding 一 > Expand All 
快捷 键 : 

Mac: shift + command + "+" 


Windows\Linux: Ctrl + Shift + "+" 


an i BoB AG IR 
操作 步骤 : 
菜单 栏 :Code 一 > Folding 一 > Collapse All 


快捷 键 : 


Mac: shift + command + "-" 


Windows\/Linux: Ctrl + Shift + "-" 


Ke FP Ae ay Be a SOE PAD PT A EAE 
使 用 此 功能 会 自动 展开 当前 文件 里 的 所 有 注释 ,不 会 展开 代码 o 


展开 代码 注释 : Code 一 > Folding 一 > Expand doc comments 


折 且 代码 注释 : Code 一 > Folding 一 > Collapse doc comments 


指定 展开 层级 


指定 展开 代码 层级 : Code -- Folding -- Expand to level 


指定 全 部 展开 代码 的 层级 : Code -- Folding -- Expand all to level 


af BRA A P AR 

bP Ray BRAG ER. 

操作 步骤 : 

菜单 栏 :Code 一 > Folding 一 > Fold Selection V Remove regio 


快捷 键 : Mac: command + . | WindowsVLinux: Ctrl + . 


选中 的 代码 就 会 被 折 重 ， 再 触发 一 次 ， 代 码 就 会 被 展开 . 
fa bs 几 
a fe ARA H ER 
WAG RA AGP AAG A A ELARA H R. 
操作 步骤 : 
菜单 栏 :Code 一 > Folding 一 > fold code block 


快捷 键 : 


Mac: shift + command + . 


WindowsVLinux: Ctrl + Shift + . 


代码 模板 


Live Template ( 实时 模板 ) 


Live Template 就 是 把 常用 的 代码 提取 成 一 个 模板 ,在 编写 代码 的 时 候 可 以 通过 缩写 调 出 这 个 模 
板 ,达到 快速 输入 ,提高 效率 的 目的 . 


Android Studio 中 提供 的 Live Template 定 义 了 一 些 常 用 的 缩写 ， 我 们 可 以 通过 输入 缩写 快速 生 
成 常用 的 代码 模板 。 


操作 步骤 : 


菜单 栏 :Code 一 > Insert Live Template 


快捷 键 : 


Mac: command + J 
Windows\/Linux: Ctrl + J 

然后 在 弹出 的 列表 中 选取 缩写 。 
当然 也 可 以 : 


直接 输入 LiveTemplate 定 义 的 缩写 ,然后 按 下 Tab 键 插入 。 
常用 缩写 


Log.d(""); 


使 用 代码 模板 包 


操作 步骤 : 

菜单 栏 :Code 一 > Surround with Live Template 
快捷 键 : 

Mac: option + command + J 


WindowsVLinux: Ctrl + Alt + J 


然后 选择 代码 模板 
在 Select Template 弹 窗 中 点 击 模板 或 输入 模板 前 面 的 大 写字 母 都 可 以 插入 代码 模板 . 
编辑 Live Templates 


TEVE th TR : 


菜单 栏 : File->Settings -> Editor -> Live Templates 


5 `~ f 2- 

注释 行 

操作 步骤 : 

菜单 栏 : Code 一 > Comment with Line Comment 


快捷 键 : 


Mac: command + V 


WindowsVLinux: Ctrl + V 


注释 代码 块 
操作 步骤 : 


菜单 栏 : Code 一 > Comment with Block Comment 


快捷 键 : 


Mac: option + command + V 


Windows\V/Linux: Ctrl + Shift + V 


格 亏 化 代码 


操作 步骤 : 
菜单 栏 : Code 一 > Reformat Code 


右键 菜单 : Reformat Code 


快捷 键 : 


Mac: option + command + L 


Windows\V/Linux: Ctrl + Alt + L 


配置 格式 化 选项 


通过 快捷 键 (Mac): option + command + shift + L 打开 配置 对 话 框 


操作 步骤 : 


菜单 栏 : Code 一 > Auto-Indent Lines 


快捷 键 : 


Mac: option + control + | 


Windows\V/Linux: Ctrl + Alt + | 


删除 多 余 导 入 
当 有 多 余 包 的 导入 的 时 候 ， 可 以 使 用 此 方法 去 掉 多 余 导 入 


操作 步 又: 


菜单 栏 : Code 一 > Optimize Imports 


快捷 键 : 


Mac: control + option + O 
Windows\VLinux: Ctrl + Alt + O 


右 击 文件 菜单 :Optimize Imports 
重新 排列 代码 

操作 步骤 : 

菜单 栏 :Code 一 > Rearrange Code 
向 上 移动 代码 


如 果 要 移动 一 段 代 码 , 需要 先 选中 这 段 代码 . 


如 果 要 移动 方法 , 光标 需要 定位 在 方法 名 上 . 
操作 步骤 : 
菜单 栏 : Code 一 > Move Statement Up 


快捷 键 : 


Mac: shift + command + + 


Windows\Linux: Ctrl + Shift + 个 


向 下 移动 代码 
如 果 要 移动 一 段 代码 , 需要 先 选中 这 上 段 代 码 . 


如 果 要 移动 方法 , 光标 需要 定位 在 方法 名 上 . 


操作 步 又: 


菜单 栏 :Code -- Move Statement Down 


快捷 键 : 


Mac: shift + command + ¢ | 


Windows\Linux: Ctrl + Shift + 个 


了 解 Lint 


211 


Lint 命 令 使 用 


212 


第 十 草 重 构 


重 构 ， 是 指 在 不 改变 外 部 行为 的 条 件 下 ， 对 现 有 的 代码 进行 改善 ， 以 增加 可 读 性 ， 使 设计 和 
逻辑 更 加 清晰 。Android Studio 的 重 构 功 能 可 以 帮助 我 们 安全 、 简 单 、 快 速 的 完成 代码 重 构 。 


重 命名 
操作 步 又: 
菜单 栏 : Refactor --> Rename 


快捷 键 : 


Mac: fn + Shift + F6 


a >> 
提炼 方法 
提炼 方法 ( Extract Method) ， 把 一 段 代 码 提取 出 来 作为 一 个 单独 的 方法 使 用 。 
操作 步 又: 
菜单 栏 : Refactor 一 > Extract 一 > Method 


快捷 键 : 


Mac: option + Command + M 


提炼 方法 对 象 


操作 步骤 : 


菜单 栏 : Refactor 一 > Extract 一 > Method Object... 


~ > ele 
更 改 方法 签名 
改变 方法 的 名 称 , 改 函 数 的 可 访问 性 ,对 参数 进行 添加 、 删 除 、 重 命名 和 重新 排序 。 


操作 步骤 : 


菜单 栏 : Refactor --> Change Signature 


快捷 键 : 


Mac: fn+ command + F6 


迁移 变量 类 型 ( Type Migration ) 


改变 变量 的 类 型 。 
操作 步骤 : 


菜单 栏 : Refactor --> Type Migration 
快捷 键 


Mac: fn+ Shift + Command + F6 


转 成 静态 方法 


操作 步骤 : 


菜单 栏 : Refactor-->Make Static 


静态 方法 转 为 实例 方法 


操作 步骤 : 


菜单 栏 : Refactor --> Convert to Instance Method 


3 zh Æ 
移动 类 
把 一 个 类 移动 到 不 同 的 包 下 
可 以 直接 把 类 托 动 到 目标 地 址 
操作 步 又: 
菜单 栏 : Refactor 一 > Move... 


快捷 键 


Mac: fn + F6 (可 能 会 跟 系 统 快 捷 键 冲突 ) 


移动 静态 方法 
操作 步骤 : 
菜单 栏 : Refactor 一 > Move... 


快捷 键 : 


Mac: fn + F6 (可 能 会 跟 系 统 快捷 键 冲突 ) 


Ya >> EN 
移动 静态 字段 
操作 步 又: 
菜单 栏 : Refactor 一 > Move... 


快捷 键 : 


Mac: fn + F6 (可 能 会 跟 系统 快捷 键 冲突 ) 


安全 删除 


为 了 保证 安全 的 删除 , Android Studio 会 找到 被 删除 字符 , 结果 会 在 工具 栏 展示 ,可 以 在 删除 之 
前 对 代码 进行 修正 。 


操作 步骤 : 


菜单 栏 : Refactor 一 > Safe Delete... 


日 ` 下 EL 
提炼 为 变量 
将 一 个 表达 式 提 炼 为 一 个 变量 ,并 使 用 变量 替换 原来 的 表达 式 . 


操作 步 又: 


菜单 栏 : Refactor 一 > Extract 一 > Variable... 


快捷 键 : 


Mac: option + Command + V 


a 1 Wy 号 
提炼 为 第 量 
临时 变量 快速 提炼 出 静态 常量 
操作 步骤 : 
菜单 栏 : Refactor 一 > Extract 一 > Constant... 


快捷 键 : 


Mac: option + Command + C 


日 > YL 
提炼 字段 
将 选中 的 表达 式 赋 值 给 一 个 新 声明 的 字段 ， 原 来 的 表达 式 被 新 的 宇 段 代替 。 


操作 步骤 : 


菜单 栏 : Refactor 一 > Extract 一 > Field... 


快捷 键 : 


Mac: option + Command + F 


日 +z 
提炼 和 参数 
在 方法 中 添加 新 的 参数 , 且 更 新 这 个 方法 的 调用 。 


操作 步骤 : 


菜单 栏 : Refactor 一 > Extract 一 > Parameter... 


快捷 键 : 


Mac: option + Command + P 


提炼 委托 


提炼 委托 重 构 是 在 一 个 类 中 提炼 一 些 字段 和 方法 到 一 个 单独 的 、 新 创建 的 类 中 。 


当 一 个 类 变 得 太 大 并 且 做 了 太 多 的 事情 时 , 我们 就 需要 考虑 重 构 , 将 这 个 类 拆 分 为 更 小 、 更 有 
凝聚 力 的 类 。 


操作 步骤 : 


菜单 栏 : Refactor 一 > Extract 一 > Delegate... 


提炼 援 口 
提炼 接口 重 构 是 从 一 个 已 存在 的 类 中 提炼 接口 。 


操作 步骤 : 


菜单 栏 : Refactor 一 > Extract —> Interface ... 


提炼 父 类 


操作 步骤 : 


菜单 栏 : Refactor 一 > Extract 一 > Superclass... 


内 联 方法 
操作 步 又: 
菜单 栏 : Refactor —>Inline 


快捷 键 : 


Mac: option+Command + N 


内 联 临 时 变量 


操作 步 又: 


菜单 栏 : Refactor —>Inline 


快捷 键 : 


Mac: option+Command + N 


查找 并 替换 重复 代码 


操作 步骤 : 


菜单 栏 : Refactor 一 > Find and Replace Code Duplicates... 


反 转 布尔 值 


把 一 个 Boolean 方 法 或 变量 改变 为 相反 的 意义 ,也 就 是 原来 是 true 的 变 为 false， 原 来 是 false 的 交 
A true ° 


操作 步骤 : 


菜单 栏 : Refactor 一 > Invert Boolean 


把 成 员 拉 到 父 类 


操作 步骤 : 


菜单 栏 : Refactor 一 > Pull Members Up... 


把 成 员 推 到 子 类 


操作 步骤 : 


菜单 栏 : Refactor 一 > Push Members Down... 


尽 可 能 使 用 援 口 


操作 步骤 : 


菜单 栏 : Refactor 一 > Use Interface Where Possible... 


使 用 委托 替换 继承 


操作 步骤 : 


菜单 栏 : Refactor 一 > Replace Inheritance with Delegation... 


移 除 中 间 人 


操作 步骤 : 


菜单 栏 : Refactor 一 > Remove Middleman... 


eS 
包装 方法 返回 值 
使 用 一 个 新 建 的 包装 类 来 替换 一 个 方法 的 返回 值 , 这 个 类 也 可 以 是 已 存在 的 类 . 


操作 步骤 : 


菜单 栏 : Refactor —> Wrap Return Value... 


将 匿名 类 转 成 内 部 类 
把 一 个 匿名 类 转 成 内 部 类 


操作 步骤 : 


菜单 栏 : Refactor 一 > Convert Anonymous to Inner... 


HRP 


操作 步骤 : 


菜单 栏 : Refactor 一 > Encapsulate Field ... 


使 用 查询 替换 临时 变量 


操作 步骤 : 


菜单 栏 : Refactor 一 > Replace Temp with Query... 


使 用 工厂 方法 替换 构造 方法 


操作 步 又: 


菜单 栏 : Refactor 一 >Replace Constructor with Factory Method... 


32 FAY 
将 那些 没有 使 用 泛 型 的 代码 转化 为 泛 型 可 识别 的 代码 


操作 步骤 : 


菜单 栏 : Refactor 一 > Gentrify... 


迁移 
把 项 目 中 使 用 的 老 包 和 类 切换 为 新 包 


操作 步骤 : 


菜单 栏 : Refactor 一 > Migrate... 


第 十 一 章 打包 构建 (Gradle) 


在 Android Studio 上 ， 打 包 运 行 ， 导 入 的 包 管 理 ， 都 是 使 用 Gradle， 所 以 了 解 Gradle 是 非常 
必要 的 。 这 章 我 们 一 起 学 习 Gradle ° 


Gradle 是 什么 ? 


Gradle 是 一 个 自动 化 构建 工具 ,采用 Groovy 的 Domain Specific Language (领域 特定 语言 ) 来 
描述 和 控制 构建 逻辑 . 它 的 特点 是 语法 简洁 、 可 读 性 强 、 配 置 灵活 等 等 . AT Intellij IDEA 社 区 
版 本 开发 的 Android Studio 天 生 支 持 Gradle 构 建 程序 . 


Gradle 使 用 指南 请 看 :https:VVdocs.gradle.orgVcurrentVuserguideVuserguide.html 
Groovy 是 什么 ? 


Groovy 是 一 种 基于 JVM 的 敏捷 开发 语言 , 它 结合 了 Python、Ruby、Smalltalk 的 许多 强大 特性 . 
Groovy 代码 既 能 够 与 Java 代码 很 好 的 结合 ,也 能 够 用 于 扩展 现 有 的 代码 . 


更 多 Groovy 请 参考 :http:VVwww.groovy-lang.orgV 
Gradle 的 特点 : 
。 Gradle 支 持 多 工程 构建 和 局 部 构建 . 


© Gradle 支 持 远程 或 本 地 依赖 管理 : 支持 从 远程 maven 仓 库 、nexus 私 服 、ivy 仓 库 以 及 本 地 
仓库 获取 依赖 . 


e Gradle 与 Ant、Maven 兼 容 . 


e Gradle 可 轻松 迁移 ; Gradle 适 用 于 任何 结构 的 工程 .我 们 可 以 在 同一 个 开发 平台 平行 构建 原 
工程 和 Gradle 工 程 . 


e Gradle 使 用 灵活 : Gradle 的 整体 设计 是 以 作为 一 种 语言 为 导向 的 ,而 非 成 为 一 个 严格 死板 的 


框架 . 


Gradle 免 费 开 源 Gradle 跟 IDE 集 成 的 非常 好 


Gradle 可 以 更 容易 地 集成 到 自动 化 构建 系统 


Gradle 中 的 Project、Task 和 Plugin 


m AEA? 


项 目 (project) 是 指 我 们 的 构建 产物 (比如 Jar 包 ) 或 部 署 的 产物 (将 应 用 程序 部 署 到 生产 环 
境 ) ,每 个 项 目 包 含 一 个 或 多 个 任务 . 


住 务 太 什么 ? 


任务 (Task) 是 指 不 可 分 的 最 小 工作 单元 ， 代 表 一 个 逻辑 上 较为 独立 的 执行 过 程 ,比如 :编译 、 复 
制 、 打 包 . 


日 
插件 是 什么 ? 
Gradle 只 是 提供 了 构建 项 目的 一 个 框架 ,所 有 有 用 的 特性 都 由 Gradle 插 件 提供 ， 一 个 Gradle 插 
件 能 够 : 


。 向 项 目 中 添加 新 任务 

© 为 新 加 入 的 任务 提供 默认 配置 ， 这 个 默认 配置 会 在 项 目 中 注入 新 的 约定 (如 源 文件 位 置 ). 
e 加 入 新 的 属性 , 可 以 覆盖 插件 的 默认 配置 属性 . 

© 为 项 目 加 入 新 的 依赖 . 


更 多 请 参考 : http:WWwww.gradle.orgVdocsVcurrentVuserguideVstandard_plugins.html 


项 目 、 任 务 和 插件 的 关系 是 什么 ? 


项 目 代表 要 被 构建 的 组 件 或 整个 项 目 , 它 为 任务 提供 了 执行 的 上 下 文 ， 而 插件 用 来 向 项 目 中 添 
加 属性 和 任务 .一 个 任务 可 以 读 取 和 设置 项 目的 属性 以 完成 特定 的 操作 . 


如 何 配置 Gradle 构 建 ? 


Gradle 的 构建 肯定 会 包含 下 面 这 几 个 配置 文件 : 
Gradle 构 建 脚本 (build.gradle) 指定 了 一 个 项 目 和 它 的 任务 . 
Gradle 属 性 文件 (gradle.properties) 用 来 配置 构建 属性 . 


Gradle 设 置 文件 (gradle.settings) 对 于 只 有 一 个 项 目的 构建 而 言 是 可 选 的 ,如 果 我 们 的 构建 中 
包含 多 于 一 个 项 目 ， 那 么 它 就 是 必须 的 . 


因为 它 描 述 了 哪 一 个 项 目 参与 构建 .每 一 个 多 项 目 构建 都 必须 在 项 目 结构 的 根 目 录 中 加 入 一 个 
设置 文件 gradle.settings. 


Gradle 中 依赖 的 仓库 


Te 
Ry Je FEAF AP? 
顾名思义 ,仓库 就 存放 东西 的 . 放 什么 东西 呢 ? 简单 来 说 就 是 存放 我 们 依赖 的 jar 包 ， 


Gradle 支 持 哪些 仓库 ? 


e Maven 仓 库 
e |vy 仓 库 
© 平 级 目录 仓库 


如 何在 构建 中 加 入 这 些 仓库 ?3 


lvy 仓 库 应 该 用 的 人 不 多 吧 , 这 里 就 不 多 作 介 绍 了 ,重点 放 在 maven 仓 库 上 . 
在 build.gradle 中 添加 仓库 的 声明 ,方法 如 下 : 


从 Maven 仓 库 中 获取 依赖 


repositories { 


1. 从 指定 的 远程 maven 仓 库 中 获取 依赖 
maven { 


url "http://maven.helloword.net/repo" 


} 


2. 从 指定 的 本 地 maven 仓 库 中 获取 依赖 
maven { 


url "file:///Users/bixiaopeng/mvn" 


} 


3. 从 中 央 Maven 仓 库 中 获取 依赖 


mavenCenter () 


4. 从 新 的 中 央 远 程 仓库 中 获取 依赖 


jcenter() 


5. 从 本 地 仓库 中 获取 依赖 


mavenLocal() 


6 .需要 认证 的 库 
maven { 
credentials { 
username 'user' 


password 'password' 


} 


url "http://repo.helloword.com/maven2" 


} 


} 


Maven 人 仓库 的 三 种 别名 
为 了 更 加 方便 的 加 入 Maven 仓 库 , Gradle 为 我 们 提供 了 3 种 别名 ,分 别 是 : 


1.mavenCentral() : 


表示 从 maven 中 央 仓 库 中 获取 依赖 地 址 : http:VVrepo1.maven.orgVmaven2 


2.jcenter(): 


jcenter 是 一 个 新 的 远程 中 央 人 仓库， 兼容 maven 中 央 人 仓库， 而 且 性 能 更 优 . 


gradle 默 认 使 用 jcenter 作 为 仓库 . 


jcenter # 2 # 3x © :https:VVbintray.comV/ 


3.mavenLocal(): 
表示 从 本 地 Maven 仓 库 中 获取 依赖 。 本 地 地 址 : {user.home}V.m2\Vrepository 
从 平 级 目录 仓库 中 获取 依赖 


从 本 地 目录 中 获取 依赖 ,在 build.gradle 中 添加 : 


repositories { 
// 从 当前 项 目的 平 级 目录 1ib 中 获取 依赖 
flatDir(dir: 'lib', name: ‘libs directory') 
// 从 当前 项 目的 平 级 目录 LibA 和 1ibB 中 获取 依赖 
flatDir { 
dirs 'libA', '1ibB' 
name = 'All dependency directories' 


} 


配置 Gradle 环 境 


本 文 以 Mac 上 配置 Gradle 环 境 为 例 进 行 介绍 . 


一 .下载 gradle 


1.1 下 载 地 址 : http://gradle.org/gradle-download/ 
1.2 下 载 最 新 版 本 :gradle-2.13 (当前 最 新 版 为 2.13) 


当然 你 也 可 以 选择 下 载 某 一 个 历史 版 本 ,在 页 面 右边 Choose Vesion 中 选择 下 载 到 本 地 后 解压 ， 


二 . 配置 环境 变量 


2.1 我 的 本 地 存放 路 径 :/Volumes/warehouse/dev-tools/tools-jars/gradle-2.132.2 编 
“4 bash_profile : vim ~/.bash_profile2.3 配置 环境 变量 : 


export GRADLE HOME=/Volumes/warehouse/dev-tools/tools-jars/gradle-2.13 


export PATH=$PATH: $GRADLE_HOME/bin 


2.3. 使 配置 立即 生效 : source ~/.brash_profile 


三 . 查看 配置 是 否 成 功 


~$ gradle -v 


Build time: 2016-04-25 04:10:10 UTC 

Build number: none 

Revision: 3b427b1481e46232107303c90be7b05079b05bic 

Groovy: 2.4.4 

Ant: Apache Ant(TM) version 1.9.6 compiled on June 29 2015 
JVM: 1.8.0 91 (Oracle Corporation 25.91-b14) 


OS: Mac OS X 10.11.2 x86_64 


如 果 电 脑 上 不 单独 配置 Gradle 环 境 也 没关系 , AA Android Studio 中 使 用 了 Gradle Wrapper, È 
可 以 在 我 们 没有 安装 gradle 的 时 候 进 行 项 目 构建 ,下 面 我 们 会 讲 到 . 


Windows 和 Linux 上 配置 Gradle 的 开发 环境 方法 差不多 ,这 里 就 不 一 一 介绍 了 . 


Gradle Wrapper 


Gradle Wrapper íł 2 ? 


Gradle Wrapper 可 以 理解 为 是 对 Gradle 的 一 层 封装 ,使 用 它 可 以 在 没有 安装 Gradle 的 系统 上 使 
用 Gradle 来 构建 项 目 . 


如 何 做 到 的 呢 ? 


Gradle Wrapper 通 过 两 个 脚本 文件 实现 这 一 功能 ,一 个 是 用 于 windows 的 批 处 理 文件 
gradlew.bat, 一 个 是 用 于 Linux 和 Uninx 的 Shell 脚 本 文件 gradlew. 使 用 Android Studio 创 建 的 项 目 
默认 为 我 们 生成 了 Gradle Wrapper 的 文件 结构 . 


在 gradle/wrapper 目 录 下 有 两 个 文件 : gradle-wrapper.jar 和 gradle-wrapper.properties gralde- 
wrapperproperties 文 件 中 声明 了 gradle 的 版 本 和 下 载 地 址 . 


#Mon Dec 28 10:00:20 PST 2015 
distributionBase=GRADLE_USER_HOME 
distributionPath=wrapper/dists 
ZipStoreBase=GRADLE_USER_HOME 
ZipStorePath=wrapper/dists 


distributionUrl=https\://services.gradle.org/distributions/gradle-2.10-all.zip 


在 第 一 次 使 用 gradlew 进 行 项 目 构建 的 时 候 ,Gradle Wrapper 会 自动 下 载 gralde- 
wrapperproperties 指 定 的 gradle 版 本 . 
通过 gradlew 执 行 gradle 构 建 跟 直 接 使 用 gradle 是 一 样 的 . 如 果 我 们 想 直接 使 用 gradle 构 建 
需要 先 配置 环境 变量 . 


初始 化 构建 环境 


在 第 一 次 使 用 gradlew 进 行 项 目 构建 的 时 候 ,会 对 构建 环境 进行 初始 化 ， 会 把 Gradle 的 安装 包 、 
插件 和 相关 依赖 下 载 下 来 . 在 Terminal 中 输入 命令 ,如 下 : 


$ ./gradlew clean 


Downloading https://services.gradle.org/distributions/gradle-2.10-all.zip 


Unzipping /Users/bixiaopeng/.gradle/wrapper/dists/gradle-2.10-all/3i2gobhdl0fm2tosnn15 
g54010/gradle-2.10-all.zip to /Users/bixiaopeng/.gradle/wrapper/dists/gradle-2.10-all/ 
3i2gobhd10fm2tosnn15g9540i0 


Set executable permissions for: /Users/bixiaopeng/.gradle/wrapper/dists/gradlea-2.4-al 
1/3i2gobhdl0fm2tosnn1595401i0/gradle-2.10/bin/gradle 


8BUILD SUCCESSFUL 


首次 执行 命令 行 会 先 去 下 载 gradle 安 装 包 ， 过 程 可 能 会 非常 慢 ,如 果 你 不 着 急 , 就 耐心 等 一 下 
巴 。 要 不 然 就 试 试 下 面 的 方法 。 


解决 Gradle 下 载 太 慢 的 问题 


第 一 步 : 首先 我 们 要 知道 gradle 从 哪里 下 载 ,下 载 什 
么 版 本 ? 


方法 1 : 在 gradle-wrapper.properties 中 查看 gradle 下 载 地 址 和 版 本 


本 例 中 ,下 载 地 址 是 : https:VVservices.gradle.orgVdistributionsVgradle-2.10-all.zip ,版 本 是 
2.10. 


方法 2 : 去 查看 所 有 分 发 的 gradle 版 本 地 址 :https:VVservices.gradle.orgVdistributions 
在 这 里 可 以 查看 到 最 新 的 gradle 版 本 ， 点 击 可 下 载 . 
第 二 步 : 下 载 完成 后 放 到 什么 地 方 ? 


本 例 : \/UsersVquankeV.gradleVwrapperVdistsVgradle-2.4-allV/3i2gobhdl0fm2tosnn15g540i0 

你 的 : VUsersV 你 的 用 户 名 V.gradleVwrapperVdistsVgradle- 版 本 号 -allV 一 堆 随 机 生成 字符 串 ， 

这 一 堆 字符 是 随机 生成 的 ， 每 次 发 现 新 的 可 下 载 的 版 本 的 时 候 就 会 生成 一 堆 新 的 字符 ,如 果 想 
让 AndroidStudio 识 别 我 们 的 版 本 ， 需 要 先生 成 这 堆 字符 哦 。 


可 以 先 打 开 Android Studio 看 有 没有 生成 这 堆 字 符 串 ,如 果 没 有 你 就 执行 下 命令 哮 . 
第 三 步 : 给 gradle 脚 本 设置 可 执行 权限 


本 例 : chmod +x VUsersVquankeV.gradleVwrapperVdistsVgradle-2.4- 
allV3i2gobhdl0fm2tosnn15g540i0Vgradle-2.4VbinVgradle 


你 的 : chmod +x VUsersV 你 的 用 户 名 V.gradleVwrapperVdistsVgradle- 版 本 号 -allV 一 堆 随 机 生成 
字符 串 VbinVgradle 


然后 重新 打开 Android Studio,gradlew* A RÈ T VA A dè. 
下 面 我 们 不 单纯 的 来 讲 Gradle, 而 是 通过 其 在 Android 项 目 中 的 应 用 来 一 一 讲解 . 
方法 二 : 设置 代理 


翻 墙 以 后 妈妈 再 也 不 用 担心 我 的 学 习 了 . 


查看 和 执行 Gradle 任 务 


查看 当前 项 目 支 持 哪些 Gradle 任 务 
使 用 .Vgradlew task 来 查看 当前 项 目 支持 哪些 Gradle 任 务 . 


FirstApp$ ./gradlew task 


:tasks 


androidDependencies - 显示 项 目的 Android 依 赖 
signingReport - 显示 每 个 变种 版 本 的 签名 信息 . 
sourceSets - 打印 出 所 有 在 这 个 项 目 中 定义 的 Source 集 合 . 
Build tasks( 构 建 任务 ) 

assemble - 编译 并 打出 应 用 程序 所 有 变种 版 本 的 包 . 
assembleAndroidTest -编译 并 打出 所 有 测试 应 用 的 包 ， 
assembleDebug - 编译 并 打出 Debug 版 本 的 包 ， 
assembleRelease - 编译 并 打出 Release 版 本 的 包 ， 
build - 执行 所 有 检查 并 编译 打包 

buildDependents - 检查 所 有 的 依赖 并 编译 打包 ， 
buildNeeded - 检查 所 有 的 依赖 并 编译 打包 ， 


clean - 删除 构建 目录 


compileDebugAndroidTestSources 

compileDebugSources 

compileDebugUnitTestSources 

compileReleaseSources 

compileReleaseUnitTestSources 

mockableAndroidJar - 创建 一 个 适用 于 单元 测试 的 android.jar 版 本 ， 
Build Setup tasks (构建 设置 任务 ) 

init - 被 始 化 一 个 新 的 Gradle 构 建 . 

wrapper - 生成 Gradle wrapper 文 件 

Help tasks( 帮 助 任务 ) 

buildEnvironment - 显示 项 目 根 目录 中 声明 的 所 有 构建 脚本 的 依赖 
components - 显示 项 目 根 目录 产生 的 组 件 

dependencies - 显示 项 目 根 目录 中 所 有 依赖 的 声明 . 
dependencyInsight - 显示 并 洞察 项 目 根 目录 中 一 个 特殊 的 依赖 关系 ， 
help - 显示 帮助 信息 

model - 显示 项 目 根 目录 的 配置 模型 , 

projects - 显示 项 目 根 目录 中 的 子 项 目 ， 

properties - 显示 项 目 根 目 录 的 属性 ， 


tasks - 显示 从 项 目 根 目 录 可 以 运行 的 任务 ( 


installDebug - 编译 打包 并 安装 Debug 版 本 的 包 ， 


installDebugAndroidTest - 编译 打包 并 安装 Debug 版 本 的 测试 包 到 设备 上 


uninstallAll - RMAF HI E. 

uninstallDebug - #p#kDebugik % óy é. 

uninstallDebugAndroidTest - 从 设备 上 卸载 Debug 版 本 的 Android 测 试 包 
uninstallRelease - #p#ReleasenmkAW é, 

Verification tasks( 验 证 任务 ) 

check - 运行 所 有 检查 . 

connectedAndroidTest - 在 已 连接 的 设备 上 安装 所 有 flavors( 渠 道 包 ) 并 运行 instrumentation 测 试 
connectedCheck - 在 当前 已 连接 的 设备 上 运行 设备 检测 
connectedDebugAndroidTest - 在 已 连接 的 设备 上 安装 并 运行 Debug 版 本 的 测试 , 
deviceAndroidTest - 在 所 有 提供 的 设备 上 安装 并 运行 jnstrumentation 测 试 . 
deviceCheck - 在 所 有 提供 的 设备 和 测试 服务 器 上 运行 设备 检测 ， 

lint - 在 所 有 变种 版 本 上 运行 ]int 检 测 ， 

lintDebug - 在 Debug 版 本 上 运行 ]int 检 测 ， 

lintRelease - 在 Release 版 本 上 运行 ]int 检 测 . 

test - 在 所 有 变种 版 本 上 运行 单元 测试 ， 

testDebugUnitTest - 在 Debug 版 本 上 运行 单元 测试 ， 

testReleaseUnitTest - 在 Release 版 本 上 运行 单元 测试 , 

Other tasks (其 它 任务 ) 

jarDebugClasses 

jarReleaseClasses 
transformResourceswithMergeJavaResForDebugUnitTest 
transformResourceswithMergeJavaResForReleaseUnitTest 

想 查看 所 有 任务 和 更 多 详情 ， 请 运行 gradlew tasks --all 

想 查看 一 个 任务 的 更 多 详情 ， 请 运行 gradlew help --task <task> 


BUILD SUCCESSFUL 


Total time: 6.717 secs 


这 个 构建 可 以 更 快 ， 请 考虑 使 用 Gradle 守 护 : https://docs.gradle.org/2.10/userguide/gradle_daemo 
n.html 


#47 Gradlet£ 4+ 


gradle + 任务 名 称 
x 
.Vgradlew + 任务 名 称 


注意 : Gradle 的 Android 插 件 提供 了 四 个 顶级 任务 : 打包 (assemble)、 检 测 (check)、 构 建 
(build)、 清 理 (clean), 当 我 们 执行 一 个 顶级 任务 的 时 候 会 同时 执行 与 其 依赖 的 任务 . 


比如 你 执行 : .Vgradlew assemble 


它 会 把 你 配置 的 所 有 构建 类 型 (Build Types) 全 部 打出 来 ,默认 的 构建 类 型 是 Debug 和 Release， 
此 最 起 码 它 会 执行 两 个 任务 : 


gradlew assembleDebug 

gradlew assembleRelease 

如 果 有 其 它 的 构建 类 型 ,任务 名 应 该 是 : 
gradlew assemble+ 构 建 类 型 名 


另外 你 还 要 知道 ,执行 构建 (build) 任 务 会 执行 检测 (check) 和 打包 (assemble) 任 务 . 


常用 Gradle 任 务 


1. 查 看 gradle 版 本 


$ ./gradlew -v 


2. 编 译 并 打出 Debug 版 本 的 包 . 


./gradlew assembleDebug 


3. 编 译 并 打出 Release 版 本 的 包 . 
./gradlew assembleRelease 

4. 执 行 检查 并 编译 打包 
./gradlew build 


打出 所 有 Release 和 Debug 的 包 . 


5. 删 除 build 目 录 


./gradlew clean 


会 把 app 下 面 的 build 目 录 删 掉 


6. 编 译 打包 并 安装 Debug 版 本 的 包 
./gradlew installDebug 


7.3 R Debughk A 6y &, 


./gradlew uninstallDebug 


8. 使 用 -info 查 看 任务 详情 


./gradlew uninstallDebug -info 


Gradle Li ġ u 


Gradle 工 具 窗 口 列 出 了 当前 项 目 和 模块 中 支持 的 所 有 Gradle 任 务 和 运行 配置 ， 以 方便 我 们 快 
速 操作 . 


Tasks: 

Tasks 列 表 里 的 任务 跟 我 们 执行 .Vgradlew task 得 到 的 任务 列表 是 一 样 的 . 
把 光标 放 在 某 个 任务 上 面 显示 任务 的 描述 信息 : 

双击 任务 即 可 执行 

任务 执行 结果 : 


点 击 Run 工 具 栏 左上 角 的 切换 按钮 , 可 以 在 任务 执行 模式 和 文本 式 之 间 切 换 . 


Run Configurations: 


Run Configurations 列 表 中 列 出 了 项 目 中 执行 过 的 任务 配置 ,这 些 配置 都 是 执行 任务 时 自动 生成 
的 . 


想 再 次 执行 的 时 候 可 以 在 配置 列表 中 直接 选择 . 


可 以 在 RunVDebug Configurations 中 对 这 些 配 置 进行 修改 . 


构建 项 目 和 模块 


编译 项 目 


当 我 们 只 想 对 修改 过 的 文件 进行 编译 时 就 会 使 用 Make 进 行 编译 . 它 可 以 指定 对 项 目 (Project) 或 
模块 (Module) 进 行 编译 . 


编译 项 目 会 同时 编译 当前 项 目 中 所 有 的 模块 ,如 果 代 码 较 多 ,编译 时 间 会 比较 长 .如 果 想 编译 快 
一 点 需要 指定 编译 菜 个 模块 . 


操作 步 又: 
菜单 栏 --> Build --> Make Project 


快捷 键 : 


Mac: Command + F9 
WindowsVLinux: Ctrl + F9 


在 启动 app 之 前 默认 会 先 执行 Make 编 译 项 目 . 


编译 模块 


前 提 条 件 : 选中 某 个 模块 


菜单 栏 --> Build --> Make Module ' 模 块 名 ' 


设置 自动 编译 项 目 


前 面 我 们 讲 了 编译 项 目 是 对 新 产生 变化 的 文件 进行 一 次 编译 ,已 经 编译 过 的 文件 就 不 用 重 编译 
T. 所 以 如 果 你 想 加 快 编译 速度 ,可 以 设置 项 目 自动 编译 . 


操作 步 又: 


Android Studio --> Preferences... --> 搜索 Compiler --> 4 #Make project automatically 


重新 构建 项 目 


操作 步骤 : 


菜单 栏 : Build --> Rebuild Project( 重 新 构建 项 目 ) 


Make Project#& Rebuild Project 的 区 别 


Make Project 跟 Rebuild Project 都 是 执行 相同 的 两 个 任务 , 那 他 们 的 区 别 是 什么 ? 


最 明显 示 的 区 别 就 是 执行 时 间 , 从 上 面 的 例子 中 我 们 可 以 看 出 ,Make Project 用 时 4.5 秒 ,而 
Rebuild Project 用 时 需要 16 秒 . 


为 什么 Rebuild Project 会 慢 这 么 多 ? 

因为 Rebuild Project 是 对 整个 项 目 进 行 了 重新 编译 ,不 管 你 之 前 有 没有 编译 过 ,因此 用 时 会 比较 
长 . 

而 Make Project 只 是 对 新 产生 变化 的 文件 进行 一 次 编译 ,已 经 编译 过 的 文件 就 不 用 重 编译 了 ,所 
有 用 时 比较 少 . 


AER 
清理 项 目 
清理 项 目 会 清空 output 目 录 下 的 文件 ,并 重新 编译 项 目 . 


操作 步 又: 


菜单 栏 : Build --> Clean Project( 清 理 项 目 ) 


Gradle Script 


我 们 把 项 目 查看 模式 切换 成 Android, 所 有 的 文件 会 通过 类 型 进行 归 类 ,这 个 并 不 是 实际 在 电脑 
中 的 文件 结构 哦 ， 如 果 想 看 实际 的 物理 结构 请 切换 到 Project. 


切换 成 Android 可 以 查看 所 有 的 Gradle Script: 
每 个 文件 后 面 都 有 一 个 灰色 字体 描述 : 

1.build.gradle: Project 构 建文 件 

2.build.gradle: Module 构 建文 件 

3.gradle.properties : gradle 配 置 文件 
4.proguard-rules.pro: 混淆 规则 配置 文件 
5.graddle-wrapper.properties: gradle wrapper 属 性 文件 
6.settings.gradle: 构建 项 目 设 置 文件 

7.local.properties: SDK、NDK 配 置 文件 

切换 到 Project 模 式 我 们 来 看 看 各 个 文件 之 间 的 关系 : 


项 目 中 有 一 个 app 模 块 ,这 个 模块 是 一 个 Android 应 用 程序 , 它 有 自己 的 构建 脚本 和 混淆 配置 文 
件 . 


项 目 根 目录 下 的 脚本 文件 是 针对 它 所 依赖 模块 的 全 局 配置 . 


下 面 我 们 详细 介绍 一 下 每 个 文件 的 作用 . 


Gradlewi £ X #:gradle- 
wrapper.properties 


gradle-wrapper.properties 是 gradle wrapper 的 配置 文件 . 


默认 的 gradle-wrapperproperties 文 件 内 容 如 下 : 


#Mon Dec 28 10:00:20 PST 2015 
distributionBase=GRADLE_USER_HOME 
distributionPath=wrapper/dists 
ZipStoreBase=GRADLE_USER_HOME 
ZipStorePath=wrapper/dists 


distributionUrl=https\://services.gradle.org/distributions/gradle-2.10-all.zip 


一 般 这 个 文件 是 不 用 动 的 ,除非 你 想 手 动 指定 gradle 的 版 本 ,可 以 修改 distributionUrl. 也 可 以 在 
Project Structure 一 > Project 中 设置 Gradle version. 


项 目 全 局 配置 文件 :settings.gradle 


默认 的 settings.gradle 文 件 内 容 如 下 : 
include ':app' 
settings.gradle 是 项 目的 全 局 配置 文件 ,主要 声明 一 些 需 要 加 入 构建 的 模块 ,本 例 中 只 有 一 个 模 
块 :app. 
如 果 新 增 一 个 模块 需要 在 这 里 添加 配置 ,通过 Android Studio 添 加 依赖 的 module 会 自动 在 这 里 
添加 相应 的 配置 的 . 
包含 多 个 模块 的 格式 是 这 样 的 : 
include ':app', ':other-module-name' 
如 果 和 包含 的 是 某 个 目录 下 的 模块 ,格式 是 这 样 的 : 


include ':app', ':dir-name:other-module-name' 


本 地 属性 配置 文件 :local.properties 


默认 的 local.properties 文 件 内 容 如 下 


# 这 个 文件 是 由 Android Studio 自 动 生成 的 ， 不 要 修改 这 个 文件 - - -如 果 你 改 了 也 会 被 自动 擦 除 ， 
# 这 个 文件 不 能 被 添加 到 版 本 控制 系统 中 ,因为 它 包 含 的 信息 只 针对 你 本 地 系统 的 配置 ， 

# 本 地 的 SDK 仅 被 用 于 gradle 构 建 ， 

#Fri May 20 16:18:51 CST 2016 

ndk.dir=/../sdk/ndk-bundle 


sdk.dir=/../sdk 


我 们 可 以 在 Project Structure 一 > SDK Location 中 设置 SDK 和 NDK 的 路 径 . 


修改 后 会 同步 到 local.properties 文 件 中 . 


Gradleac £ X #+:gradle.properties 
gradle.properties 是 gradle 的 配置 文件 ，build.gradle 通 过 读 取 这 个 文件 配置 的 参数 来 进行 相应 
的 构建 . 


默认 的 gradle.properties 文 件 内 容 如 下 : 


# 设置 整个 项 目的 Gradle. 

# IDE (e.g. Android Studio) users: 

4# 通过 IDE 设 置 将 会 覆盖 Gradle settings 文 件 所 有 的 设置 ， 

# 关于 如 何 配 置 构建 环境 的 更 多 详情 ,请 访问 : 

# http://www.gradle.org/docs/current/userguide/build_environment.html 
# 指定 用 于 守护 进程 的 JVM 参 数 ， 

# 该 设置 对 调整 内 存 设置 特别 有 用 ， 

# 默认 值 ; -Xmx10248m -XX:MaxPermSize=256m 


# org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -D 
file.encoding=UTF-8 


# 配置 完毕 后 ，Gradle 将 在 并 行 模式 下 运行 . (并 行 编译 ) 
# 只 应 在 解 耦 项 目 中 使 用 此 选项 ,更 多 详情 ， 请 访问 ， 


# http://www.gradle.org/docs/current/userguide/multi project_builds.html#sec:decoupled 
_projects 


# org.gradle.parallel=true 


默认 的 gradle.properties 文 件 内 容 为 空 ,只 有 一 些 注释 .可 以 在 这 里 设置 Gradle 的 代理 在 
gradle.properties 添 加 : 


systemProp.http.proxyHost=Proxy Server 
systemProp.http.proxyPort=Proxy port 

# 设置 代理 的 用 户 名 和 密码 ,如 果 没有 就 不 用 设置 
systemProp.http.proxyUser=User 
systemProp.http.proxyPassword=password 
# 设置 不 需要 代理 的 地 址 ， 多 个 地 址 使 用 或 “| ' 隔 开 


systemProp.http.nonProxyHosts=*.baidu.com|*.taobao.com 


代码 混 清 规则 配置 文件 :proguard-rules.pro 


如 果 我 们 想 在 打包 的 时 候 进 行 代码 混淆 ,就 需要 在 proguard-rules.pro 中 配置 代码 混淆 规 则 . 
常用 的 代码 混淆 规则 : 

# 在 这 里 添加 项 目的 代码 混淆 规则 

# 混淆 规则 请 参考 :http://proguard.sourceforge.net/index.html#manual/usage.html 

HHHHEHHHHHHHHHHAHHHHE 一 般 使 用 默认 HEHE 

# 不 使 用 大 小 写 混合 类 名 , 混淆 后 的 类 名 为 小 写 

-dontusemixedcaseclassnames 

# 混淆 第 三 方 库 

-dontskipnonpubliclibraryclasses 

# 混淆 时 记录 日 志 , 有 助 于 排查 错误 

-verbose 

# 代码 混淆 使 用 的 算法 ， 


-optimizations !code/simplification/arithmetic, !code/simplification/cast, !field/*,!cla 
ss/merging/* 


# 代码 混淆 压缩 比 , 值 在 9-7 之 间 ， 软 认为 5， 

-optimizationpasses 5 

# 优化 时 允许 访问 并 修改 有 修饰 符 的 类 和 类 的 成 员 
-allowaccessmodification 

HEHEHE DICA EE 

# RRERRA 

-keep public class * extends android.app.Activity 
-keep public class * extends android.app.Application 
-keep public class * extends android.app.Service 


-keep public class * extends android.content.BroadcastReceiver 


-keep public class 


-keep public class 


-keep public class 


-keep public class 


-keep public class 


-keep public class 


-keep public class 


-keep public class 


-keep public class 


-keep public class 


# Native 方法 不 混淆 


* extends 


* extends 


* extends 


* extends 


* extends 


* extends 


* extends 


* extends 


* extends 


android.content.ContentProvider 


android.app.backup.BackupAgent 


android.preference.Preference 


android.support.v4.app.Fragment 


android.support.v4.app.DialogFragment 


com.actionbarsherlock.app.SherlockListFragment 


com.actionbarsherlock.app.SherlockFragment 


com.actionbarsherlock.app.SherlockFragmentActivity 


android.app.Fragment 


com.android. vending. licensing. ILicensingService 


-keepclasseswithmembernames class * { 


native <methods>; 


# 自 定义 组 件 不 混淆 


-keep public class * extends android.view.View { 


public <init>(android.content.Context); 


public <init>(android.content.Context, android.util.AttributeSet ); 


public <init>(android.content.Context, android.util.AttributeSet, int); 


public void set*(. 


di 


H 自 定义 控件 类 和 类 的 成 员 不 混淆 (所 有 指定 的 类 和 类 成 员 是 要 存在 ) 


-keepclasseswithmembers class * { 


public <init>(android.content.Context, android.util.AttributeSet ); 


# 同上 


-keepclasseswithmembers class * { 


public <init>(android.content.Context, android.util.AttributeSet, int); 


# 自 定义 控件 类 不 混淆 
-keepclassmembers class * extends android.app.Activity { 


public void *(android.view.View) ; 


H 枚 举 类 不 被 混淆 
-keepclassmembers enum * { 
public static **[] values(); 


public static ** valueOf(java.lang.String); 


# android.os.Parcelableti FR ARA 
-keep class * implements android.os.Parcelable { 


public static final android.os.Parcelable$Creator *; 


# 资源 类 不 混淆 

-keepclassmembers class **.R$* { 

public static <fields>; 

+E = ROR TA EE 
# 保留 第 三 方 库 android.support.V4 不 被 混 消 

-keep class android.support.v4.app.** { *; } 

-keep interface android.support.v4.app.** { *; } 

# 打包 时 忽略 警告 

-dontwarn android.support.** 


# 如 果 你 的 项 目 中 使 用 了 第 三 方 库 , 需要 参考 官方 文档 的 说 明 来 进行 混淆 配置 


# 例如 : 百度 地 图 的 配置 ZF :http://developer.baidu.com/map/sdkandev-question.htm 
#-keep class com.baidu.** { *; } 
#-keep class vi.com.gdi.bgl.android.**{*;} 


# 例如 : 支付 宝 的 混淆 参考 : https://doc.open.alipay.com/doc2/detail.htm?treeId=59&articlel 
d=103683&docType=1 


#-libraryjars libs/alipaySDK-20150602. jar 


#-keep class com.alipay.android.app.IAlixPay{*;} 

#-keep class com.alipay.android.app.IAlixPay$Stub{*; } 

#-keep class com.alipay.android.app.IRemoteServiceCallback {*;} 
#-keep class com.alipay.android.app.IRemoteServiceCallback$Stub{*;} 
#-keep class com.alipay.sdk.app.PayTask{ public *;} 


#-keep class com.alipay.sdk.app.AuthTask{ public *;} 


混淆 规则 配置 文件 配置 好 以 后 ,需要 在 build.gradle 中 开启 混淆 


项 目 构建 配置 文件 build.gradle 


Project:build.gradle 是 用 来 配置 项 目的 构建 任务 . 默认 的 build.gradle 内 容 如 下 : 


// 项 目 构建 文件 ， 你 可 以 到 各 子 项 目 /模块 添加 常用 的 配置 选项 ， 
buildscript { 

//Android 插 件 从 这 个 仓库 中 下 载 

repositories { 


jcenter() // 依赖 仓库 源 的 别名 , 兼容 maven 的 远程 中 央 仓 库 


// 依 赖 

dependencies { 

// android gradledé 

classpath 'com.android.tools.build:gradle:2.2.0-alpha1' 

// RT: 

// 请 不 要 在 此 处 添加 应 用 程序 依赖 ;它们 应 该 在 单个 Module (模块 )build.gradle 文 件 中 添加 


// 这 里 添加 的 应 该 只 是 Project 的 依赖 


// 此 处 配置 Project 中 默认 的 仓库 源 , 包括 每 个 module 的 依赖 
// 这 样 每 个 hodule 就 不 用 单独 配置 仓库 了 

allprojects { 

repositories { 


jcenter() 


// 打包 前 执行 Clean 任 务 


// 任务 类 型 是 Delete 
// clean 任 务 就 是 删除 项 目 根 目录 下 的 build 目 录 (build 为 输出 目录 ) 
task clean(type: Delete) { 


delete rootProject.buildDir 


buildscript 中 的 repositories 是 指定 Android 插 件 的 仓库 源 . 


allprojects 中 的 repositories 是 指定 整个 Project 中 默认 的 仓库 源 . 


在 Project Structure 中 设置 


我 们 可 以 在 Project Structure 一 > Project 中 设置 Gradle 和 Android 插 件 的 版 本 ,以 及 Android 插 件 
和 默认 第 三 方 库 的 仓库 源 . 


Project Structure 和 Project build.gradle 对 应 的 关系 : 


模块 构建 配置 文件 :build.gradle 


Module:build.gradle 是 用 来 配置 模块 的 构建 任务 . 


默认 的 build.gradle 文 件 内 容 如 下 : 


// 插 件 : 

// 这 个 module 是 一 个 android 程 序 , 使 用 com.android.application 
// 如 果 是 android 库 ,应 该 使 用 com.android.1library 

apply plugin: 'com.android.application' 

android {//android 程 序 构建 需要 配置 的 参数 

// 编 译 使 用 的 SDK 版 本 

compileSdkVersion 23 

//buildtool 版 本 

buildToolsVersion "23.0.2" 

defaultConfig {// 默 认 配 置 

applicationId "com.wirelessqa.basebuildsample" //apk 包 名 
// 最 小 SDK 版 本 

minSdkVersion 16 

// 目 标 SDK 版 本 

targetSdkVersion 23 

//version code 

versionCode 1 

// 应 用 程序 的 版 本 

versionName "1.0" 

//android 单 元 测试 test runner 


testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" 


// 构 建 类 型 ， 此 处 配置 debug 和 release 版 本 的 一 些 参数 ， 像 混淆 、 签 名 配置 ， 
buildTypes { 

//release 版 本 的 配置 

release { 

// 是 否 开启 混淆 

minifyEnabled false 

// 指 定 混淆 文件 及 混淆 规则 配置 文件 的 位 置 


proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 


// 模 块 依赖 

dependencies { 

// 编 译 依赖 1ibs 目 录 下 所 有 jar 包 

compile fileTree(dir: 'libs', include: ['*.jar']) 
// 编 译 依 赖 appcompat 库 


compile 'com.android.support:appcompat-v7:23.4.0' 


模块 构建 配置 文件 :build.gradle 也 可 以 在 项 目 结构 中 配置 ,下 面 我 们 详细 介绍 一 下 . 


项 目 结 构 中 配置 模块 构建 


Project Structure 用 来 配置 项 目 和 模块 的 各 种 构建 参数 和 属性 ,前 面 我 们 已 经 介绍 过 了 SDK 
Location 和 Project 的 配置 ,本 章 主要 介绍 模块 构建 的 一 些 配置 . 


打开 Project Structure 对 话 框 : 
RIE DK : 
菜单 栏 : File 一 > Project Structure 


快捷 键 : 


Mac: command + ; 


Windows/Linux: Ctrl + Shift + Alt + S 


工具 栏 : 


Modules: 用 来 设置 模块 构建 配置 文件 中 的 属性 、 签 名 、 渠 道 特性 、 构 建 类 型 和 依赖 . 


配置 应 用 程序 属性 


Compile Sdk Version: 指定 Android 的 编译 版 本 . 
对 应 build.gradle 文 件 中 的 参数 是 : 


compileSdkVersion 23 


Build Tools Version: 指定 构建 工具 的 版 本 . 
对 应 build.gradle 文 件 中 的 参数 是 : 
buildToolsVersion "23.0.2" 
SDK 编 译 版 本 和 构建 工具 的 版 本 都 是 我 们 已 经 下 载 到 本 地 的 ,如 果 本 地 没有 就 不 会 出 现在 选择 
列表 中 . 
Library Repository: 指定 依赖 的 仓库 源 ， 


默认 Project 的 build.gradle 中 已 经 指定 了 全 局 的 仓库 源 ,默认 都 是 jcenter. 因 此 这 里 可 以 为 空 .如 
果 重 新 指定 ,将 会 覆盖 project build.gradle 中 的 配置 . 如 果 此 处 指定 从 maven 中 央 仓 库 下 载 依 赖 ， 
相应 的 module build.gradle 文 件 中 会 新 增 下 面 的 参数 : 


aaptOptions { 
ignoreAssetsPattern 'bixiaopeng' 


} 


Incremental Dex: 增 量 dex 打 包 


开启 此 功能 可 以 提升 编译 打包 的 速度 ,因为 是 增 量 打包 而 不 是 全 量 . 补充 : Dex 将 .class 文 件 转 为 
Dalvik VM 能 识别 的 .dex 文 件 如 果 打 开 增 量 打包 dex 为 true, 相 应 的 build.gradle 文 件 中 会 增加 下 
面 的 参数 : 


dexOptions { 


incremental true 


配置 应 用 程序 签名 


如 果 我 们 在 这 里 配置 了 签名 ,相应 的 在 module app 的 build.gradle 文 件 中 会 自动 添加 下 面 的 配 
置 : 


// 签名 配置 

signingConfigs { 

MySigning { 

keyAlias 'myandroid' 

keyPassword '123456' 

storeFile file('/Users/quanke/myandroid.jks') 


storePassword '123456' 


对 比 一 下 使 用 maven 打 包 ,pom 里 的 签名 配置 : 


<!-- Sign apk --> 

<1-- 签 名 文件 路 径 - -> 
<sign.keystore>/Users/bixiaopeng/release.keystore</sign.keystore> 
<1-- 签 名 文件 别名 - -> 

<sign.alias>laobi</sign.alias> 

<1-- 签 名 文件 别名 密码 - -> 

<sign.keypass>222222</sign.keypass> 

<!--E4 04 8 --> 


<sign.storepass>222222</sign.storepass> 


配置 应 用 程序 签名 
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配置 应 用 程序 的 特性 


多 渠道 打包 要 在 Flavors 中 配置 相应 的 属性 . 

Name: Flavor 的 名 字 , 如 我 们 常用 的 渠道 :xiaomi、baidu 

Min Sdk Version: 向 下 兼容 的 最 小 SDK 版 本 

Application Id: 应 用 程序 的 包 名 

Proguard File: 指定 混 消 文件 路 径 , 如 果 不 指定 会 使 用 默认 的 . 
Signing Config: 指定 签名 文件 . 签名 的 文件 在 Signing 中 设置 . 
Target Sdk Version: 目标 SDK 版 本 

Test Instrumentation Runner: 指定 Test Runner 

Test Application Id: 测试 应 用 的 ID 

Version Code: 应 用 程序 的 版 本 号 ,用 于 升级 

Version Name: 应 用 程序 的 版 本 名 称 


Version Name Suffix : 应 用 程序 版 本 名 称 的 后 组 


新 增 一 个 Flavor: 


新 增 一 个 Flavor, 所 有 的 参数 都 允许 重新 设置 ,如 果 不 设置 的 都 使 用 defaultConfig 的 配置 . 


// 产品 特性 
productFlavors { 
xiaomi {} // 渠 道 名 name 为 Xiaomi 


baidu { 


wandoujia {} 
// 自动 替换 AndroidManifest.Xxm1L 中 的 渠道 号 
productFlavors.all { flavor -> 


flavor.manifestPlaceholders = [CHANNEL_ID: name] 


RC { 

minSdkVersion 20 

applicationId 'com.wirelessqa.basebuildsampleRC' 

proguardFile '/Users/bixiaopeng/myandroid.jks' 

signingConfig signingConfigs.MySigning 

targetSdkVersion 22 

testInstrumentationRunner '‘android.support.test.runner.AndroidJUnitRunner ' 
versionCode 1 

versionName '1.0.1' 


versionNameSuffix 'RC' 


针对 不 同 的 APP 分 发 渠道 ,我 们 可 以 定义 不 同 的 productFlavors( 产 品 特性 ). 
也 可 以 定义 APP 开 发 不 同 阶段 的 版 本 ,比如 :内 测 版 本 、 灰 度 版 本 、 正 式 版 本 . 


也 可 以 为 不 同 的 版 本 指定 不 同 的 Applicationld( 包 名 )， 这 样 在 同一 个 设备 上 可 以 同时 安装 两 个 
版 本 ,方便 测试 . 


有 了 上 面 的 配置 你 在 执行 打包 命令 的 时 候 就 会 打出 不 同 有 当道 的 包 . 


配置 应 用 程序 的 构建 类 型 


构建 类 型 Build Types 非 常 重要 ， 在 这 里 可 以 配置 构建 版 本 的 一 些 非 常 重要 的 参数 ， 默 认 有 两 
个 构建 版 本 :debug 和 release 。 


默认 的 debug 和 release 的 区 别 只 有 Debugable( 是 否 可 调试 ),debug 默 认可 调试 ,release 默 认 不 
可 以 调试 . 


Name: 构建 类 型 名 称 
Debugable: 是 否 可 以 调试 
Jin Debuggable: Jin 是 否 可 以 调试 


Signing Config: 指定 签名 ,同样 是 在 signing 中 配置 的 ,如 果 为 空 则 不 签名 ,打出 来 的 包 也 是 未 签 
名 过 的 . 


Renderscript Debuggale: 是 否 使 用 演 染 脚本 (一 种 低级 的 高 性 能 编程 语言 ， 用 于 3D 演 染 和 处 
理 密集 型 计算 ) 


Renderscript Optim Level: Rendescript 版 本 . 
Minify Enabled: 是 否 混淆 

Pseudo Locales Enabled: 是 否 支持 本 地 化 整理 
Proguard File: 指定 混淆 文件 路 径 

Application Id Suffix: 应 用 程序 |d 后 缀 

Version Name Suffix: 版 本 名 称 后 级 


Zip Align Enabled: 是 否 支 持 Zip Align( 字 节 码 对 齐 ) 


新 增 一 个 构建 类 型 : 


修改 后 build.gradle 文 件 中 同步 修改 为 : 


buildTypes { 
release { 
minifyEnabled false 


proguardFiles getDefaultProguardFile\('proguard-android.txt'\), 'proguard-rules.pro' 


bbbbb { 

debuggable true 

jniDebuggable true 

renderscriptDebuggable true 

minifyEnabled true 

pseudoLocalesEnabled true 

proguardFile '\/Users\/bixiaopeng\/proguard-android.txt' 
applicationIdSuffix '.daily' 

versionNameSuffix '\_0705' 


ZipAlignEnabled true 


如 果 我 们 指定 打 茶 个 构建 类 型 的 包 可 以 这 样 指定 : 
打出 Debug 的 包 : .Vgradlew assembleDebug 
打出 Release 的 包 : .Vgradlew assembleRelease 
打出 Bbbbb 的 包 : .Vgradlew assembleBbbbb 


我 们 试 着 打出 Bbbbb 这 种 类 型 的 包 : 


$ ./gradlew assembleBbbbb 
:app:preBuild UP-TO-DATE 
:app:preBaiduBbbbbBuild UP-TO-DATE 


:app: checkBaiduBbbbbManifest 


:app:packageXiaomiBbbbb 
:app:assembleXiaomiBbbbb 
:app:assembleBbbbb 

BUILD SUCCESSFUL 


Total time: 25.301 secs 


在 appVbuildVoutputVapk 目 录 下 就 会 打出 相应 的 apk 包 . 


解析 apk, 查 看 包 名 和 版 本 号 跟 我 们 配置 的 一 致 


~$ aapt d badging /Volumes/FirstApp/app/build/outputs/apk/app-baidu-bbbbb-unsigned.apk 
package: name='com.baidu.firstapp.daily' versionCode='1' versionName='1.0_0705' 
sdkVersion:'8' 


targetSdkVersion:'22' 


Project Structure 中 没有 的 配置 但 buildTypes 中 支持 的 属性 还 有 很 多 ,我 们 举 个 例子 : 


// 显示 Log 
buildConfigField "boolean", "LOG_DEBUG", "true" 
// 移 除 无 用 的 resource 文 件 ,minifyEnabled 必 须 为 true 


shrinkResources true 
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置 应 用 程序 的 依赖 


我 们 在 这 里 添加 模块 中 依赖 的 jar 包 、 文 件 和 模块 ,还 可 以 配置 它们 的 作用 范围 


build.gradle 中 配置 的 依赖 我 们 在 上 面 已 经 介绍 过 ,这 里 再 提 一 下 下 ,这 两 个 依赖 配置 
定编 译 时 需要 依赖 libs 目 AE ii ója cte andit 


dependencies { 

compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:22.+' 
// 此 为 新 增 依赖 


androidTestCompile 'junit:junit:4.12' 


的 意 


AZ 


操作 步 又: 
第 1 步 : 签名 证 书 配置 窗口 : Build 一 > Generate Signed Apk 一 > 选择 Module 一 > Next 
然后 弹出 签名 证 书 配置 窗口 : 


我 们 可 以 点 击 【Choose existing】 来 选择 一 个 已 存在 的 签名 证 书 ,也 可 以 使 用 上 次 使 用 过 的 签 
名 证 书 . 


第 2 步 : 输入 选择 证 书 的 存储 密码 和 密 钥 密码 ,如 果 不 想 每 次 都 输入 密码 ,请 匀 选 Remember 
passwords. 


第 3 步 : 点 击 Next, 要 求 我 们 输入 Master Password. 

Master Password 是 用 来 保护 我 们 存储 在 Android Studio 数 据 库 中 的 密码 的 . 
如 果 忘 记 了 密码 是 无 法 进行 到 下 一 步 的 . 

怎么 解决 这 个 问题 呢 ? 

方法 一 : 在 当前 窗口 中 重 置 密 码 

点 击 (Reset... ] —> 弹出 重 置 Master 密 码 窗 口 一 > 输入 新 的 密码 一 > OK 
点 击 [Yes] 确认 重 置 操作 . 

方法 二 : 到 偏好 设置 中 重 置 密码 

如 果 你 记得 密码 ,直接 输入 密码 . 

Master password 只 会 在 我 们 第 一 次 使 用 时 要 求 输入 

BAW: 配置 应 用 程序 构建 类 型 和 存储 位 置 : 

APK Destination Folder: 指定 应 用 程序 存储 位 置 (默认 放 在 app 根 目录 下 ). 
Build Type: 构建 类 型 

Flavors: 渠道 (没有 就 使 用 默认 配置 ) 

第 5 步 : 点 击 [Finish] 之 后 开始 打包 任务 . 

在 Gradle Console 工 具 窗 口 可 以 查看 任务 执行 的 过 程 : 


打包 成 功 后 在 IDE 的 右上 角 弹 出 打包 成 功 提 示 . 


生成 的 APK 存 储 在 第 4 步 指定 的 位 置 , RUE appVbuildVoutputsVapk A F. 


然后 这 个 包 你 就 可 以 发 布 到 应 用 市 场 啦 ， 


Riedy E 


E A Android A FRA360` bK ` MEK. ARSSERS HER, 如 果 我 们 想 统计 每 
道 的 下 载 量 和 活跃 度 ,就 需要 使 用 统计 平台 . 


我 们 以 友 盟 统计 为 例 ,介绍 如 何 配置 渠道 信息 并 执行 自动 化 打包 . 


1. 在 AndroidMainfest.xml 配 置 可 动态 替换 的 渠道 参数 


友 盟 集成 文档 中 有 说 明 , 使 用 友 盟 统计 需要 在 AndroidMainfest.xml 配 置 相应 的 渠 


<meta-data 
android :name="UMENG_CHANNEL" 


android:value="xiaomi" /><1!-- 渠 道 号 为 :小 米 --> 


如 果 想 动态 的 替换 渠道 号 怎么 办 呢 ? 


<meta-data 
android :name="UMENG_CHANNEL" 


android:value="${CHANNEL_ID}" /><1!-- 动 态 替换 渠道 号 - -> 


2. 在 build.gradle 中 配置 渠道 信息 和 自动 替换 脚本 


ME 


不 


productFlavors { 
xiaomi {} // 渠 道 名 name 为 Xiaomi 
baidu {} 


wandoujia {} 


// 自动 替换 AndroidManifest.xml 中 的 渠道 号 
productFlavors.all { flavor -> 


flavor.manifestPlaceholders = [CHANNEL_ID: name] 


配置 好 以 后 在 Build Variants 窗 口中 可 以 选择 不 同 渠 道 的 变种 版 本 : 


Gradle 工 具 栏 也 会 生成 相应 的 任务 : 
3. 默 认 配 置 


// 默认 配置 

defaultConfig { 

applicationId "com.wirelessqa.basebuildsample" //apk 包 名 
minSdkVersion 16 

targetSdkVersion 23 

versionCode 1 

versionName "1.0" // 版 本 号 

//android 单 元 测试 test runner 


testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" 


PR AR RERE FA KR ie E te RR AER RK, T AE productFlavors*# & 89 Ria > PH Ak 
配置 . 


4. 打 包 后 自动 修改 apk 的 名 字 


// 打包 后 自动 修改 apk 的 名 字 
// release 包 的 命名 格式 为 :产品 名 _ 版 本 号 _ 渠 道 号 .apk 


// debug 包 的 命名 格式 为 :产品 名 _ 版 本 号 _ 渠 道 号 _Debug_ 打 包 时 间 .apk 





applicationVariants.all { variant -> 

variant.outputs.each { output -> 

def outputFile = output.outputFile 

if (null != outputFile && outputFile.name.endswith('.apk')) { 
File outputDir = new File(outputFile.parent); 


def baseName = PRODUCT_NAME + "${defaultConfig.versionName}" + "_" + variant.productF 
lavors[0].name 


def newApkName 


if (variant.buildType.name.equals('release')) { 
newApkName = baseName + '.apk' 
} else if (variant.buildType.name.equals('debug')) { 


newApkName = baseName + "_Debug_${packageTime()}.apk" 


output.outputFile = new File(outputDir, newApkName) 


5. 自 动 化 打包 


如 何 一 次 打出 所 有 渠道 的 Release 的 包 呢 ? 


方法 一 : 命令 行 : 


$ ./gradlew assembleRelease 


方法 二 : GradleeLA |v: 


方法 三 : 菜单 栏 一 > Build 一 > Generate Signed APK 一 > 一 步 步 下 去 一 > Flavors 中 全 选 一 
Finish. 


这 样 所 有 渠道 的 Release 包 都 被 打出 来 了 . 


6. 查 看 数 道 号 是 否 被 正确 替换 . 
单 击 apk 之 后 ,Android Studio 会 自动 解析 apk, 这 样 我 们 就 可 以 在 Android Studio 中 直接 查看 apk 
的 信息 了 
1. 单 击 baidu 这 个 渠道 一 >2. 点 击 AndroidManifest.xml 一 >3. 查 看 渠道 号 为 baidu 
由 此 证 明 我 们 的 打包 脚本 是 OK 的 . 
如 果 要 打 Debug 包 ,执行 assembleDebug 任 务 就 可 以 了 . 


如 果 只 想 打 某 一 个 渠道 的 包 ,执行 对 应 的 打包 任务 就 可 以 了 . 


本 例 中 全 部 的 build.gradle 脚 本 如 下 : 


// 插 件 : 
// 这 个 module 是 一 个 android 程 序 , 使 用 com.android.application 
// 如 果 是 android 库 ,应 该 使 用 com.android.1library 


apply plugin: 'com.android.application' 


// 产 品名 

def PRODUCT_NAME = "wirelessqa" 
// 打 包 时 间 

def packageTime() { 


return new Date().format("MMddhhmmss", TimeZone.getTimeZone("GMT+8")) 


android { 


// 签名 配置 

signingConfigs { 

MySigning { 

keyAlias 'myandroid' 

keyPassword '123456' 

storeFile file('/Users/bixiaopeng/myandroid.jks') 


storePassword '123456' 


// 编译 sdk 版 本 
compileSdkVersion 23 
// 构建 工具 版 本 


buildToolsVersion "23.0.2" 


// 默认 配置 

defaultConfig { 

applicationId "com.wirelessqa.basebuildsample" //apk 包 名 
minSdkVersion 16 

targetSdkVersion 23 

versionCode 1 

versionName "1.0" // 版 本 号 


//android 单 元 测试 test runner 


testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" 


versionNameSuffix 'test' 


// 产品 特性 
productFlavors { 
xiaomi {} // 渠 道 名 name 为 Xiaomi 


baidu { 


wandoujia {} 
// 自动 替换 AndroidManifest.xml 中 的 渠道 号 
productFlavors.all { flavor -> 


flavor.manifestPlaceholders = [CHANNEL_ID: name] 


// 构建 类 型 ,此 处 配置 debug 和 release 版 本 的 一 些 参数 ， 像 混 消 、 签 名 配置 ， 

buildTypes { 

// release 包 的 配置 

release { 

// BRA 

minifyEnabled true 

// 指定 混淆 文件 

proguardFiles getDefaultProguardFile( 'proguard-android.txt'), 'proguard-rules.pro' 
// 指定 签名 配置 

signingConfig signingConfigs.MySigning 


ZipAlignEnabled true 


// 移 除 无 用 的 资源 文件 


shrinkResources true 


// 打包 后 自动 修改 apk 的 名 字 
// release 包 的 命名 格式 为 :产品 名 版 本 号 _ 渠 道 号 .apk 


// debug 包 的 命名 格式 为 :产品 名 _ 版 本 号 _ 渠 道 号 _Debug_ 打 包 时 间 .apk 





applicationVariants.all { variant -> 


variant.outputs.each { output -> 


def outputFile = output.outputFile 


if (null != outputFile && outputFile.name.endswith('.apk')) { 


File outputDir = new File(outputFile.parent); 


def baseName = PRODUCT_NAME + "${defaultConfig.versionName}" + "_" + variant.productF 
lavors[@].name 


def newApkName 


if (variant.buildType.name.equals('release')) { 


newApkName = baseName + '.apk' 


} else if (variant.buildType.name.equals('debug')) { 


newApkName = baseName + "_Debug_${packageTime()}.apk" 


output.outputFile = new File(outputDir, newApkName) 


// 依赖 的 第 三 方 库 


dependencies { 


compile fileTree(include: ['*.jar'], dir: 'libs') 


compile 'com.android.support:appcompat-v7:23.4.0' 


compile 'com.android.support.constraint:constraint-layout:1.0.0-alpha1' 


compile 'com.android.support:design:23.4.0' 


testCompile 'junit:junit:4.12' 


androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.2' 


androidTestCompile 'com.android.support.test:runner:0.5' 


androidTestCompile 'com.android.support:support-annotations:23.4.0' 


配置 开发 者 服务 


开发 者 服务 中 都 是 google 提 供 的 一 些 非常 实用 的 服务 ,包括 :广告 、 分 析 、 身 份 验证 、Firebase 
和 通知 . 


第 十 二 章 运行 调试 


调试 是 每 个 程序 员 必 备 的 技能 ， 代 码 总 会 出 现 问题 ， 为 了 解决 问题 并 验证 程序 的 正确 性 ， 我 
们 总 会 用 到 调试 功能 。Android Studio 中 强大 的 调试 功能 可 以 帮助 我 们 快速 定位 问题 。 


运行 和 调试 配置 

打开 运行 和 调试 配置 的 方法 : 

菜单 栏 : Run 一 > Edit Configurations... 

快捷 键 : 

Mac: control + alt + R 

Windows/Linux: Alt + Shift + F9 一 > 0 工具 栏 : 点 击 Edit Configurations... 


然后 弹出 配置 界面 : 


Defaults 列 出 了 所 有 默认 的 配置 ,点击 + 按钮 可 以 新 建 一 个 新 的 Android 启 动 /调试 配置 . 
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Name: 

名 字 . 可 以 在 工具 栏 运行 应 用 程序 配置 的 下 拉 列 表 中 看 到 。 
General: 

在 这 里 配置 安装 、 局 动 、 部 署 应 用 程序 选项 

Module: 


列表 中 列 出 了 当前 项 目 中 的 所 有 模块 ,我 们 可 以 指定 相应 的 模块 来 运行 


Installation Options: 安装 选项 

1.Deploy: 下 拉 列 表 中 列 出 了 应 用 程序 运行 时 的 部 署 模式 

有 三 个 选项 

Default APK: 部 署 默 认 的 APK, 运行 时 会 先 打 包 安 装 , 再 启动 APK。 

Custom Artifact: 部 署 自 定义 的 APK, 会 根据 你 选择 的 模块 来 选择 对 应 的 配置 。 


Nothing: 不 做 任何 部 署 ,运行 时 会 直接 启动 应 用 ,如 果 应 用 已 经 安装 了 会 直接 启动 , 没有 安装 就 
会 报错 。 


2.Install Flags: 给 adb shell pm install 添加 运行 参数 ,参数 参加 在 pm install 后 面 。 


Install Flags 为 空 时 ,运行 应 用 程序 时 执行 的 命令 是 这 样 的 : 


# 1. 把 打 好 的 包 放 到 手机 中 的 /data/local/tmp/ 目 录 下 


$ adb push /Volumes/MyApplication/app/build/outputs/apk/app-debug.apk /data/local/tmp/ 
com.wirelessqa.myapplication 


# 2. 重 新 安装 应 用 程序 
$ adb shell pm install -r "/data/local/tmp/com.wirelessqa.myapplication" 
pkg: /data/local/tmp/com.wirelessqa.myapplication 


Success 


如 果 添 加 一 个 参数 -f 


# 2. 重 新 安装 应 用 程序 ,在 install 后 就 多 了 个 -f 参 数 
$ adb shell pm install -f -r "/data/local/tmp/com.wirelessqa.myapplication" 
pkg: /data/local/tmp/com.wirelessqa.myapplication 


Success 


Launch Option: 尼 动 选项 
1.Launch 提 供 了 四 个 选项 . 
Default Activity: 启动 默认 Activity, 运 行 时 会 启动 默认 的 MainActivity, 如 果 没 有 会 报错 。 
Specified Activity: 指定 启动 的 Activity 
在 输入 框 中 输入 Activity 的 名 字 , 输 入 时 会 有 智能 联想 : 
如 果 记 不 住 名 字 , 还 可 以 搜索 : 
或 在 项 目 结构 中 查找 : 
定义 好 启动 Activity 后 ,运行 应 用 时 这 个 Activity 就 会 被 启动 。 
Nothing: 运行 时 不 会 启动 任何 Activity. 


URL: 在 这 里 可 以 指定 启动 的 scheme. 


Xp 
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2.Launch Flags: 给 adb shell am 添加 运行 参数 ,参数 添加 在 命令 的 最 
Deployment Target Options: 部 署 目标 选项 

Target: 

Show Device Chooser Dialog : 选择 此 选项 ,每 次 运行 时 都 会 弹出 选择 设备 对 话 框 。 
USB Device: 使 用 USB 连 接 的 设备 

Emulator: 使 用 模拟 器 

Use same selection for future launches: 

如 果 勾 选 此 项 ,以 后 运行 时 都 使 用 同样 的 选择 ,不 需要 再 次 选择 了 . 

Miscellaneous: 

在 这 里 配置 日 志和 安装 选项 

Logcat: 


Show logcat automatically: 运行 时 自动 显示 logcat 日 志 。 


Clear log before launch: 启动 前 清空 日 志 。 

Installation Options: 

Skip installation if APK has not changed : 如 果 代 码 没 有 变更 ,运行 时 跳 过 
Force stop running application before launching activity ° 

启动 Activity 前 强制 关闭 运行 的 应 用 程序 . 

Debugger: 

在 这 里 配置 调试 类 型 . 


Debug 类 型 包括 : Java、Native、Hybrid.Profiling: 在 这 里 配置 图 形 跟踪 选项 


disable precompiled shaders and programs: 禁用 预 编译 着 色 器 和 程序 . 
Before launch: 


在 这 里 可 以 配置 运行 之 前 需要 执行 的 任务 ,默认 会 执行 Make. 
添加 任务 
点 击 + 添 加 一 个 新 的 任务 : 


任务 说 明 


运行 外 部 工具 ,如 果 有 的 话 可 以 直接 选择 ,如 果 没 有 可 


Run External tool 


以 去 新 建 . 
Make 编译 选择 的 模块 
Make Project 编译 项 目 


Make, no error ”编译 选择 的 模块 ， 但 不 进行 错误 校 验 
check 
Build Artifacts 构建 构件 , 如 果 有 的 话 可 以 选择 对 应 的 构件 . 


Run Gradle task 运行 Gradle 任 务 


Gradle-aware 


ie 执行 Gradlew 任 务 


BT A 


断 点 会 暂停 应 用 程序 的 运行 ,线程 被 挂 起 . 然后 我 们 可 以 通过 调试 器 一 行 一 行 的 查看 代码 . 
断 点 的 状态 分 为 已 启用 断 点 和 已 禁用 断 点 . 


已 启用 的 断 点 在 调试 状态 下 ,应 用 程序 每 次 执行 到 该 断 点 时 都 会 暂停 .[ 图 片 ] 已 禁用 的 断 点 在 调 
试 状态 下 ,不 会 对 应 用 程序 的 执行 造成 任何 影响 . 





Android Studio 中 的 断 点 分 为 很 多 类 型 , 每 一 种 断 点 都 有 它 适 用 的 场合 和 特殊 的 作用 ,了 解 这 些 
断 点 , 才 有 可 能 更 好 的 使 用 断 点 . 
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行 断 点 是 我 们 最 常用 到 的 断 点 , 它 被 用 于 对 代码 中 特定 的 行进 行 调试 . 


操作 步骤 : 

菜单 栏 : Run 一 > Toggle Line Breakpoint 
快捷 键 : 

Mac: command + F8 

WindowsVLinux: Ctrl + F8 

单 击 某 行 ( 非 方法 名 所 在 行 ) 左 边栏 即 可 设置 断 点 


取消 行 断 点 跟 添 加 行 断 点 的 方法 同 相 。 


属性 设置 
右 击 行 断 点 弹出 属性 设置 对 话 框 : 
Enabled: 断 点 启用 和 禁用 . 


Suspend: 勾 选 All, 执 行 到 断 点 时 所 有 线程 都 会 被 挂 起 . 名 选 Thread, 执 行 到 断 点 时 只 有 当前 断 点 
所 在 的 线程 会 被 挂 起 . 


切换 线程 挂 起 策略 的 时 候 , 会 显示 Make Default, 点 击 后 就 会 把 当前 选中 的 策略 变 为 默认 的 . 


Condition: 设 置 断 点 暂停 条 件 . 


方法 断 点 

方法 断 点 主要 用 来 检查 方法 的 输入 和 输出 (参数 和 返回 值 ). 
IRIE ia 

% #72: Run 一 > Toggle Method Breakpoint 

单 击 方法 名 所 在 行 的 左边 栏 

属性 设置 

右 击 方法 断 点 的 图 标 ,弹出 属性 设置 对 话 框 : 


跟 行 断 点 相 比 ,方法 断 点 的 属性 中 多 了 个 Watch, 用 来 设置 是 否 监视 方法 的 进入 和 退出 . 


Method entry 和 Method exit 默 认 都 被 选中 ,也 就 是 说 调用 此 方法 开始 的 时 候 和 结束 的 时 候 断 点 
都 会 被 触发 ,如 果 不 选 中 就 不 会 触发 . 
` n > 
FP ULI 
当 我 们 对 程序 运行 的 过 程 不 太 关 心 ,只 关心 某 个 变量 的 变化 的 时 候 可 以 使 用 字段 观察 断 点 . 
操作 步骤 
菜单 栏 : Run 一 > Toggle Field Watchpoint 
单 击 字段 所 在 行 的 左边 栏 
属性 设置 
右 击 变 量 的 断 点 图 标 ,显示 属性 设置 : 
这 里 有 两 个 选择 是 Java Field Watchpoints 特 有 的 : 


Field access: 当 字段 被 访问 的 时 候 触 发 断 点 . 


Field modification: 当 字段 被 修改 的 时 候 触 发 断 点 . 
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操作 步骤 : 


右 击 左 边栏 的 断 点 图 标 一 > Y Condition 一 > 设置 暂停 条 件 


Ie Bt BT A 
当 我 们 想 某 个 断 点 只 被 触发 一 次 后 就 自动 删除 的 时 候 ,可 以 使 用 临时 断 点 


操作 步骤 : 


菜单 栏 : Run 一 > Toggle Temporary Line Breakpoint 


快捷 键 : 


Mac: fn + command + option + shift + F8 
Windows\Linux: Ctrl + Alt + Shift + F8 
Alt + 鼠标 单 击 左边 栏 


如 果 想 把 临时 断 点 变 为 普通 断 点 可 以 在 属性 中 去 掉 Remove once hit 4 x. 


F f ET 2 

异常 断 点 会 在 某 个 异常 发 生 时 触发 断 点 ,这 样 我 们 就 可 以 第 一 时 间 得 到 异常 信息 ,方便 排查 问题 
操作 步骤 : 

菜单 栏 : Run 一 > View Breakpoints 


快捷 键 : 


Mac: fn + shift + command + F8 
Windows\/Linux: Ctrl + Alt + F8 


然后 在 打开 的 断 点 窗口 点 击 左上 的 角 的 + 号 按钮 ,选择 Java Exception Breakpoints. 


然后 在 弹出 的 [Enter Exception Class] 窗 口中 输入 你 要 调试 的 异常 , 例如 :NullPointException. 


确定 后 当 你 的 应 用 程序 抛 出 空 指针 异常 时 ,就 会 在 异常 处 触发 断 点 . 


日 志 断 点 


在 调试 的 时 候 , 我 们 想 临 时 多 加 一 些 日 志 但 又 不 想 重新 构建 应 用 程序 的 时 候 ,就 可 以 使 用 日 志 断 
点 


Na 


操作 步骤 


右 击 断 点 
日 志 信 息 表达 式 . 





展开 的 选项 中 名 选 Log evaluated expression 一 > 输入 


为 取消 了 Suspend, 所 以 执行 到 断 点 处 不 会 暂停 ,而 是 会 打印 日 志 


志 会 打印 在 Console 窗 口中 : 
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操作 步骤 


菜单 栏 : Run 一 > Toggle Breakpoint Enable 


快捷 键 : 
Mac: option + 单 击 断 点 
WindowsVLinux: Alt + 单 击 断 点 


禁用 断 点 之 后 ,在 执行 到 该 断 点 就 不 会 暂停 了 . 如 果 想 恢复 断 点 使 用 禁用 相同 的 操作 即 可 . 
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在 断 点 的 设置 对 话 框 中 我 们 可 以 查看 和 管理 项 目 中 的 断 点 ,可 以 设置 断 点 的 属性 
打开 属性 配置 窗口 


菜单 栏 一 > Run 一 > View Breakpoints 


快捷 键 : 


Mac: fn + shift + command + F8 

Windows\Linux: Ctrl + Alt + F8 

调试 工具 窗口 : 点 击 左边 工具 栏 的 View Breakpoints 
右 击 断 点 的 图 标 一 > 点 击 More 


然后 会 打开 断 点 设置 对 话 框 


调试 工具 
dE a Ye] 1X TL FL 


控制 调试 工具 用 来 管理 调试 当中 的 程序 运行 ,提供 了 如 下 常用 功能 


© 获取 线程 堆栈 
次 复 程序 运行 


当 程序 在 断 点 处 暂停 的 时 候 , 可 以 使 用 此 功能 来 恢复 程序 运行 . 如 果 有 下 一 个 断 点 , 就 会 跳 转 下 
一 个 断 点 处 . 如 果 没 有 断 点 ,程序 就 继续 运行 . 


操作 步 刀 


调试 工具 栏 : Resume Program 


快捷 键 : 


Mac: option + command + R 


Windows\/Linux: F9 

暂停 程序 运 

程序 运行 时 点 击 此 按钮 来 暂停 程序 运行 . 
操作 步骤 

调试 工具 栏 : Pause Program 

终止 进程 


当 我 们 想 终止 调试 的 时 候 可 以 直接 终止 进程 . 


快捷 键 : 


Mac: fn + command + F2 
Windows\V/Linux: Ctrl + F2 


调试 工具 栏 : Stop ' 配 置 名 ' 
查看 断 点 

IRAE DR: 

调试 工具 栏 : View Breakpoints 


快捷 键 : 


Mac: fn + shift + command + F8 


Windows\/Linux: Ctrl + Shift + F8 


禁用 断 点 


禁用 断 点 功能 可 以 切换 断 点 状态 (启用 V 禁 用 ). 我 们 可 以 暂时 禁用 项 目 中 的 断 点 去 执行 程序 ,这 
样 就 不 会 在 断 点 处 停止 了 . 


操作 步 又: 
调试 工具 栏 : Mute Breakpoints 


获取 线程 堆栈 

操作 步骤 : 

调试 工具 栏 : Get thread dump 

恢复 布局 

恢复 布局 功能 可 以 恢复 到 原始 的 布局 ,当前 所 有 的 布局 变更 都 会 被 放弃 . 


操作 步 又: 


调试 工具 栏 : Restore Layout 
设置 


ERNE DK: 

调试 工具 栏 : Settings 

Show Values Inline: 

选中 后 启动 内 联 调试 功能 ,允许 在 编辑 器 中 观察 执行 过 的 变量 的 值 . 
Show Method Return Values: 

选中 后 会 显示 上 次 执行 方法 的 返回 值 . 

Auto-Variables Mode: 


选中 后 调试 器 可 以 自动 评估 某 些 变量 (在 断 点 前 几 行 和 后 几 和 


ras 
KH 
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Sort values alphabetically: 
选中 后 窗口 中 的 变量 值 按 字母 的 顺序 排列 . 
Unmute breakpoints on session finish: 


选中 后 当 一 个 调试 会 话 完成 后 ,会 重新 启用 所 有 禁用 的 断 点 . 

步 进 调试 工具 

使 用 步 进 调试 工具 可 以 一 行 一 行 的 查看 代码 的 执行 ,就 像 程 序 执行 的 慢 镜 头 回 放 一 样 ,我 们 可 以 
显示 执行 点 

当 我 们 需要 查看 当前 的 执行 点 时 ,光标 会 立刻 定位 到 当前 执行 到 的 断 点 . 


操作 步骤 : 


调试 工具 栏 : 单 击 Show Execution Point 


快捷 键 : 
Mac: fn + option + F10 


WindowsVLinux: Alt + F10 


单 步 跳 过 


执行 单 步 跳 过 ,会 执行 下 一 行 .如果 下 一 行 是 一 个 方法 ,不 会 进入 方法 体 ,而 是 会 执行 完 此 方法 , 然 
后 跳 到 下 一 行 . 


操作 步 又: 


快捷 键 : 


Mac: fn + F8 
Windows\V/Linux: F8 


调试 工具 栏 : # Step Over 


单 步 进入 


执行 单 步 进 入 ,会 执行 下 一 行 . 如 果 下 一 行 是 一 个 方法 , 且 该 方法 如 果 是 自 定义 的 方法 , 则 会 进 
入 方法 内 . 如 果 不 是 自 定义 的 (官方 类 库 的 方法 ) 则 不 会 进入 . 


操作 步 又: 

快捷 键 : 

Mac: fn + F7 

WindowsVLinux: F7 

调试 工具 栏 : 单 击 Step Into 

强制 进入 

执行 强制 进入 ,会 进入 任何 方法 . 不 管 该 方法 是 自 定义 的 还 是 官方 类 库 的 . 
操作 步骤 : 

调试 工具 栏 : 单 击 Force Step Into 

快捷 键 : 


Mac: fn + option + shift + F7 


Windows\V/Linux: Alt + Shift + F7 


单 步 跳出 


执行 单 步 跳出 ,会 跳出 当前 进入 的 方法 ,返回 该 方法 被 调用 处 的 一 下 行 .( 注 意 :跳出 意味 着 该 方法 


调试 工具 栏 : 单 击 Force Step Out 
快捷 键 : 
Mac: fn + shift + F8 


WindowsVLinux: Shift + F8 


EFM 


如 果 你 已 经 进入 了 某 个 方法 内 ,执行 丢弃 帧 ,当前 方法 会 被 中 断 , 并 返回 到 当前 方法 被 调用 的 地 
方 . 另外 变量 的 值 也 会 回 到 最 初 . 


当 我 们 想 反 复 调 试 某 个 方法 ,观察 此 方法 一 遍 遍 的 执行 的 时 候 , 可 以 使 用 此 功能 


操作 步骤 
调试 工具 栏 : 单 击 Drop frame 
运行 到 光标 处 


在 调试 时 ,光标 可 以 放 在 任意 一 行 . 然后 执行 Run to Cursor 程 序 会 运行 到 光标 所 在 行 暂停 . HE 
这 里 的 光标 相当 于 一 个 临时 断 点 . 


操作 步骤 

快捷 键 : 

Mac: fn + option + F9 
WindowsVLinux: Alt + F9 


调试 工具 栏 : 单 击 Run to Cursor 


计算 表达 式 


执行 Evaluate Expression 会 打开 计算 表达 式 窗口 . 


操作 步 又: 
调试 工具 栏 : 单 击 Evaluate Expression 
快捷 键 : 


Mac: fn + option + F8 


WindowsVLinux: Alt + F8 


~ AXK ~ > 
计算 表达 式 
当 我 们 想 临 时 修改 某 个 变量 的 值 或 查看 其 内 部 方法 返回 值 的 时 候 , 可 以 使 用 计算 表达 式 功 能 


Android Studio 中 提供 了 一 个 计算 表达 式 和 代码 片段 的 功能 , 使 用 起 来 非常 方便 . 它 除 了 支持 正 
则 表达 式 计算 以 外 ,还 支持 操作 表达 式 , 匿 名 表达 式 和 内 部 类 的 计算 . 


两 种 计算 模式 : 

Expression Mode: 计算 单行 表达 式 

Code Fragment Mode: 计算 代码 片段 ,我们 可 以 对 声明 、 赋 值 、 循 环 和 ifVelse 进 行 计 算 . 
使 用 表达 式 计 算 功 能 时 需要 注意 : 


1. 只 有 在 调试 并 且 断 点 被 触发 的 时 候 , 才 可 以 使 用 计算 表达 式 功 能 . 也 就 是 说 如 果 不 是 在 调试 
的 状态 ,计算 表达 式 功 能 是 不 可 用 的 . 


2. 如 果 计算 表达 式 内 调用 一 个 方法 ,方法 内 又 恰好 有 断 点 ,那么 该 断 点 会 被 忽略 ,会 直接 计算 出 表 
达 式 的 值 . 
在 堆栈 帧 中 计算 表达 式 或 代码 片段 


操作 步骤 : 
1 步 : 帧 调试 窗口 中 ,选择 你 想 要 计算 表达 式 的 堆栈 帧 ， 
第 2 步 : 调用 计算 表达 式 功能 ,有 三 种 方法 : 


菜单 栏 一 > Run --> Evaluate Expression 


快捷 键 : 

Mac: fn + option + F8 

WindowsVLinux: Alt + F8 

在 编辑 器 中 光标 定位 处 右 击 ,选择 Evaluate Expression 
第 3 步 : 选择 计算 模式 


有 两 种 计算 模式 ,单行 表达 式 和 代码 片段 ,可 以 通过 中 间 的 按钮 [Code Fragment Mode] 和 
[Expression Mode] 来 切换 . 


步骤 4: 输入 表达 式 或 语句 


基于 你 选择 的 模式 输入 表达 式 或 语句 ,输入 的 时 候 会 有 补 全 提示 : 
如 果 你 给 对 象 设置 了 标签 ,那么 在 在 输入 表达 式 的 时 候 可 以 通过 标签 来 找到 对 应 的 表达 
A Android Studio 也 会 给 出 补 全 推荐 : 
步骤 5: 执行 计算 
点 击 [Evaluate] 来 进行 计算 . 


果 指 定 的 表达 式 不 能 计算 或 是 有 错误 ,点 击 [Evaluate] 后 会 给 出 可 能 的 错误 原因 . 


计算 任意 表达 式 
在 变量 调试 窗口 中 右 击 变量 一 > Evaluate Expression 
进入 表达 式 计算 窗口 
之 前 选中 的 变量 会 显示 在 表达 式 输入 框 中 . 


b ays 
可 以 切换 计算 模式 、 查 看 计算 过 的 历史 、 输 入 表达 式 
计算 表达 式 的 值 


前 提 条 件 : 
光标 放 在 放 达 式 上 或 选中 表达 式 


操作 步骤 


菜单 栏 : Run --> Quick Evaluate Expression 


快捷 键 : 


Mac: fn + option + command + F8 

WindowsVLinux: Ctrl + Alt + F8 

选中 表达 式 立 即 显 示 表 达 式 的 值 

在 调试 工具 栏 上 点 击 设置 按钮 , 匀 选 [show value on selection change] 
然后 再 去 选中 表达 式 , 会 在 表达 式 的 上 面 显示 计算 出 来 的 结果 . 


此 功能 默认 是 不 开启 的 


计算 表达 式 
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通常 我 们 调试 应 用 程序 时 ,需要 先 添加 断 点 ,再 运行 调试 (Debug). 这 样 做 会 比较 慢 ,因为 需要 重 
新 部 署 (打包 、 安 装 、 运 行 ) 应 用 程序 . 


Android Studio 提 供 了 一 种 方法 可 以 随时 调试 应 用 程序 ,不 管 当前 应 用 程序 是 否 以 调试 模式 运 
行 . 


当 我 们 想 快速 调试 一 个 正在 运行 的 应 用 程序 时 ,可 以 使 用 此 功能 


前 提 条 件 : 


应 用 程序 已 经 在 设备 上 运行 ,已 添加 断 点 . 


操作 步骤 
菜单 栏 : Run 一 > Attch Debugger to Android Process 
然后 弹出 进程 选择 对 话 框 ,选择 需要 调试 的 应 用 程序 的 进程 


确定 后 ,调试 器 窗口 被 激活 , 接 下 来 就 可 以 正常 的 调试 应 用 程序 啦 ， 


本 地 单元 测试 
本 地 单元 测试 用 来 执行 那些 对 Android 没 有 依赖 或 Android 依 赖 容易 mock 的 单元 测试 . 
本 地 单元 测试 运行 在 自己 电脑 上 ,测试 用 例 在 本 地 虚拟 机 上 编译 运行 ,执行 速度 快 . 


本 地 单元 测试 写 在 appVsrcVtestVjava 目 录 下 . 





本 地 单元 测试 使 用 JUnit 或 TestNG 测 试 框架 
使 用 的 演示 代码 
这 里 使 用 Google 官 方 开源 的 示例 进行 演示 ,地 址 :https:VVgithub.comVgooglesamplesVandroid- 
baie a eee 
使 用 的 测试 框架 


我 们 用 JUnit 测 试 框架 举例 . 


使 用 IDE 和 运行 本 地 单元 测试 


打开 BasicSample 项 目 ,在 EmailValidatorTest 编 辑 界 面 或 项 目 窗口 中 的 类 名 上 右 击 一 > Run 
‘EmailValidatorTest’ 


这 样 EmailValidatorTest 这 个 测试 类 里 面 的 所 有 测试 用 例 都 会 被 执行 
如 果 只 想 执行 某 一 个 测试 用 例 , 在 测试 用 例 名 上 右 击 , 选 择 'Run 用 例 名 :来 执行 


如 果 想 茶 个 目录 下 所 有 的 用 例 都 被 执行 ,在 目录 名 上 右 击 ,选择 ‘Run Test in 目录 名 ' 来 执行 . 


保存 临时 配置 


通过 上 面 的 方法 运行 完 测试 之 后 ,在 工具 栏 的 运行 配置 列表 中 显示 了 刚才 运行 的 测试 类 . 这 个 配 
置 是 自动 生成 的 ,如 果 需 要 保存 ,点 击 [Save ' 测 试 类 名 ' Configuration]. 


置 本 地 单元 测试 


如 果 我 们 需要 自 定义 本 地 单元 测试 配置 ,可 以 这 样 做 . 


操作 步骤 

打开 RunVDebug Configurations 对 话 框 一 > 点 击 左上 角 的 + 号 一 > JUnit 
然后 新 增 一 个 JUnit 配 置 窗口 : 

1.Name: 输入 配置 名 


2.Use classpath of module: 选择 测试 模块 ,下 拉 列 表 中 会 列 出 项 目 所 有 的 模块 ,选择 我 们 需要 测 
试 的 . 


3.Test kind: 选择 一 种 测试 范围 ,本 例 中 选择 的 是 Class 

4. 测 试用 例 配置 : Class: 选择 测试 类 

测试 用 例 配置 项 跟 我 们 选择 的 测试 范围 是 相关 联 的 . 

如 果 Test kind 选 择 Class, 显 示 测 试 类 的 配置 项 . 

如 果 Test kind 选 择 Method, 显 示 测 试 类 和 方法 的 配置 项 . 
它 Test kind 与 此 类 似 ,这 里 就 不 一 一 列举 了 . 


5.Fork mode: 用 来 指定 是 为 每 个 测试 用 例 都 创建 一 个 进程 ,还 是 所 有 测试 用 例 在 一 个 进程 中 执 
AT. 


两 个 选项 

none: 在 一 个 进程 中 执行 所 有 测试 [图 片 ] 执 行 结 果 ; 耗 时 8ms 

method : 每 个 测试 用 例 都 会 创建 一 个 测试 进程 ,这 种 方式 会 比较 慢 .[ 图 片 ] 执 行 效果 : 耗 时 19ms 
6.Repeat: 


Once : 所 有 用 例 只 执行 一 次 [图 片 ]N Times: 自 定义 用 例 执行 次 数 ,比如 :设置 5 次 ,每 一 条 用 例 都 
会 被 执行 5 次 .[ 图 片 ]Until Failure: 不 断 重复 执行 ,直到 用 例 失败 .[ 图 片 ]Until Stopped: 不 断 重复 执 
行 ,直到 手动 停止 


7.VM options: 默认 值 为 -ea, 用 来 设置 jvm 是 否 启 动 断言 机 制 . 


8.JER 环 境 , 使 用 默认 的 就 好 了 . 


人 人 LZ- 、\ 一 /一 x OS ‘ys 
使 用 命令 行 运行 单元 测试 
./gradlew test 
执行 gradle 测 试 任务 后 所 有 的 测试 用 例 都 会 被 运行 ,然后 会 产 出 测试 报告 . 
测试 报告 存放 在 址 : appVbuildVreportsVdebugVindex.htm| 


通过 gradle 工 具 栏 执行 的 效果 同 命令 行 . 


配置 Android 单 元 测试 


如 果 我 们 需要 自 定义 本 地 单元 测试 配置 ,可 以 这 样 做 . 


操作 步 又: 

打开 RunVDebug Configurations 对 话 框 一 > 点 击 左上 角 的 + 号 一 > Android Tests 
然后 新 增 一 个 Android Tests 配 置 窗口 : 

1.Name: 输入 配置 名 

2.Module : 选择 需要 测试 的 模块 

3.Test: 指定 测试 范围 

4. 指 定 instrumentation runner 

5. 指 定 目标 设备 . 


运行 Android 单 元 测试 方法 同 运行 本 地 单元 测试 
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变更 列表 
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管理 上 下 文 
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+ px JavaDoc 
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将 当前 文件 保存 为 模板 
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IDE Scripting Console 
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管理 Android 虚 拟 机 
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截图 
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录像 
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捕获 系统 信息 
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布局 解析 
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Logcat 监 视 器 
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第 十 四 章 版 本 控制 


目前 支持 CVS、SVN、Git、Mercurial 等 主流 的 版 本 控制 系统 。 在 Android Studio 中 使 用 版 本 
控制 系统 要 先 确保 你 电脑 上 已 经 配置 好 了 相应 的 工作 环境 。 


版 本 控制 系统 


假设 我 们 打开 的 是 一 个 没有 使 用 版 本 控制 的 项 目 ， 首 先 启用 Git 作 为 项 目的 版 本 控制 系统 : 
菜单 栏 : VCS 一 > Enable Version Control Integration 一 > 选择 Git 。 

然后 项 目 根 目录 下 就 多 了 个 .git， 项 目 中 的 文件 都 是 红包 的 ， 表 示 未 加 入 Git 版 本 跟踪 。 

开启 版 本 控制 集成 后 ， 我 们 就 可 以 看 到 Android Studio 中 的 版 本 控制 系统 都 有 哪些 操作 入 口 
了 。 

一 . 菜单 栏 ->VCS 


查看 菜单 栏 上 的 VCS， 可 以 看 到 版 本 控制 系统 的 所 有 功能 


二 , 右键 -> 菜 3 


右 击 要 操作 的 文件 或 文件 夹 ， 在 弹出 的 菜单 中 可 以 看 到 版 本 控制 系统 的 选项 ， 本 例 是 Git， 如 
果 你 使 用 的 是 svn， 这 里 会 显示 Subversion。 


右键 菜单 中 提供 的 功能 ， 只 包含 对 应 的 版 本 控制 系统 特有 的 功能 ， 没 有 包含 通用 的 功能 ， 这 
是 菜单 栏 的 区 别 。 


这 里 提供 的 Git 操 作 区 分 了 本 地 和 远程 的 操作 ， 操 作 分 类 更 加 明确 。 


三 . 底部 工具 栏 -> Version Control 


底部 工具 栏 会 显示 Version Control， 如 果 没 有 显示 ， 请 点 击 View 一 > Tool Windows 来 显示 。 
打开 底部 工具 栏 上 的 Version Control 会 打开 操作 面板 

这 里 很 多 功能 跟 菜 单 栏 的 VCS 中 是 相同 的 ， 但 是 这 里 操作 更 加 有 针对 性 ， 还 可 以 批量 操作 ， 
具体 用 法 我 们 后 面 讲 。 


四 , 顶部 工具 栏 -> 第 用 功能 


顶部 工具 栏 显示 了 我 们 版 本 控制 当中 最 常用 的 几 个 功能 
从 志 到 右 依次 是 :更 新 项 目 、 提 交 变 更 、 跟 远程 仓库 中 的 文件 进行 对 比 、 显 示 历 史 、 撤 消 操 
作 。 

五 . 状态 栏 -> 分 支 操作 


状态 栏 提 供 了 Git 的 分 支 操作 ， 在 这 里 我 们 可 以 对 本 地 或 远程 的 分 支 进 行 各 种 操作 ， 像 检 出 、 
创建 新 的 分 支 、 对 比 、 合 并 、 删 除 等 。 


这 些 功能 具体 怎么 用 ? 


且 听 下 回 分 解 


PIA ` 几 
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当 我 们 把 Git 的 环境 配 好 ， 在 Android Studio 的 偏好 设置 中 只 需要 使 用 上 默认 的 配置 就 可 以 了 。 一 
般 不 需要 特殊 配置 ， 但 也 不 排除 你 有 特殊 的 需求 ， 那 下 面 我 们 就 介绍 下 Git 的 偏好 设置 。 
设置 步 又: 
偏好 设置 : Version Control 一 > Git 
Path to Git executable: 


Git 执 行路 径 , 这 里 使 用 的 是 默认 路 径 ,如 果 你 自 定义 了 Git 路 径 , 这 里 要 记得 改 一 下 , 不 然 会 报错 
的 . 


SSH executable: 

执行 SSH, 默 认 是 使 用 Android Studio 内 建 的 ,你 还 可 以 选择 使 用 Native( 本 地 ) 的 . 
commit automatically on cherry-pick: 

在 cherry-pick 时 是 否 自 动 提交 . 

tips : cherry-pick 可 以 选择 某 一 个 分 支 中 的 一 个 或 几 个 commit 来 进行 操作 . 
warn if crlf line separators are about to be committed: 

如 果 回 车 换行 符 被 提交 是 否 警告 

Warn when committing in detached HEAD or during rebase: 

+e X detached HEAD 或 rebase 时 是 否 警 告 . 

tips : detached HEAD 用 来 让 HEAD 随 便 指 向 某 个 commit id > rebase H KAHRA. 
Update method: 

选择 代码 更 新 方式 :默认 分 支 VmergeVrebase 

Auto-update if push of the current branch was rejected: 

如 果 push 当 前 分 析 被 拒绝 是 否 自动 更 新 . 

Allow force push: 


是 否 允 许 强制 push. 


Git 偏 好 设置 
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A 2 Github 


为 了 后 面 方便 的 使 用 Github 来 管理 代码 ， 我 们 需要 配置 好 Github 的 账户 信息 。 


操作 步骤 : 

第 1 步 : 进入 偏好 设置 

偏好 设置 : Version Control 一 > GitHub 

第 2 步 : 输入 账户 信息 

1. 输 入 Host: https:VVgithub.com 

2. 在 Login 输 入 用 户 名 ， 在 Password 输 入 密码 (如 果 没 有 请 先 去 注册 ) 


3.Test 连 接 是 否 成 功 


从 Github 元 隆 代码 


第 一 步 : ŻA Github XK Ra 


如 果 我 们 想 使 用 Github 上 的 开源 项 目 ， 可 以 使 用 Android Studio 直 接 下 载 项 目 代 码 。 


IRAE D R: 

第 1 步 : 进入 Github 克 隆 界面 

三 个 路 径 : 

欢迎 界面 : Check out project from Version Control 一 > Github 
菜单 栏 : File 一 > New 一 > Project from Version Control 一 > Github 


菜单 栏 : VCS 一 > Checkout from Version Control 一 >Github 


第 二 步 :配置 克隆 项 目地 址 


配置 Github repository 


点 击 【 Test 】 可 测试 能 否 连 接 成 功 。 


第 三 步 :下 载 并 打开 项 目 


点 击 【 Clone 】 开 始 从 给 定 的 仓库 地 址 克隆 项 目 到 本 地 ， 完 成 后 会 弹出 一 个 【 Import Project 
from Gradle 】 确 认 对 话 框 。 


点 击 【 OK 】 打 开 项 目 。 


将 本 地 项 目 共 至 到 GitHub 


如 果 我 们 本 地 的 项 目 想 放 到 GitHub 上 开源 ， 可 以 直接 将 本 地 项 目 共享 到 GitHub。 


操作 步骤 : 


第 1 步 : 点 击 【 Share Project on GitHub 】 


打开 本 地 项 目 一 > 菜单 栏 一 > Import into Version Control 一 > Share Project on GitHub ° 


27: 确定 是 本 地 项 目 


如 果 此 项 目 已 经 在 Github 上 ， 在 Android Studio 右 上 角 会 有 相应 的 提示 信息 ， 点 击 Github 可 以 
跳 转 到 项 目 主页 。 


如 果 此 项 目 没有 在 Github 上 ， 会 弹出 一 个 新 建仓 库 的 对 话 框 : 
步 : 指 定 首次 提交 的 文件 和 提交 的 备注 

点 击 OK 以 后 在 状态 栏 会 显示 进度 . 

第 4 步 :确认 分 享 成 功 


分 享 成 功 后 在 Android Studio 的 状态 栏 和 右上 角 会 显示 成 功 提示 . 


如 果 想 查看 Github 上 到 底 有 没有 分 享 成 功 , 后 点 击 [SecondApp] 到 项 目 主页 查看 . 


查看 本 地 变更 历史 


当 你 想 查看 某 个 文件 或 文件 夹 本 地 变更 的 历史 记录 的 时 候 ,可 以 使 用 此 功能 . 


— 查看 茶 个 文件 的 本 地 变更 历史 


前 题 条 件 : 
在 文件 列表 中 选中 此 文件 或 打开 此 文件 ,光标 在 文件 中 . 


IRAE DR 

方法 一 : 点 击 右键 一 > 在 弹出 的 操作 选项 中 点 击 Local History 一 > Show History 
方法 二 : 菜单 栏 一 > VCS 一 > Local History 一 > Show History 

显示 变更 历史 

如 果 两 个 文件 有 不 同 会 提示 不 同 的 个 数 , 窗 EE 列 出 了 不 同 颜 色 表 示 的 变更 操作 . 


二 . 查看 东 段 代码 的 本 地 变更 历史 


如 果 你 想 查 看 某 段 代码 本 地 的 变更 ， 需 要 先 选中 这 段 代码 ,然后 在 Local History 列 出 的 选项 中 
选择 [Show History for Selection] 


三 , 查看 东 个 文件 夹 的 本 地 变更 历史 


如 果 想 要 查看 某 个 文件 夹 的 本 地 变更 只 需要 选中 这 个 文件 夹 ,然后 右 击 选择 Local History — > 
Show History 就 可 以 了 . 


我 们 还 可 以 为 每 次 变更 贴 上 一 个 标签 (Put Label), 只 要 在 Local History 中 选择 Put Label > AG 
输入 标签 内 容 就 可 以 了 . 


Git 添 加 文件 


在 讲 添 加 文件 之 前 我 们 先 要 了 解 下 git 中 文件 的 状态 和 提交 流程 . 
我 们 的 工具 目录 下 的 文件 只 有 两 种 状态 : 未 跟踪 和 已 跟踪 . 
未 跟踪 是 指 没有 被 纳入 版 本 控制 的 文件 ,git 就 不 会 跟踪 文件 的 变更 . 


已 跟踪 是 指 已 被 纳入 版 本 控制 的 文件 ,在 上 一 次 的 快照 中 有 它们 的 记录 ,在 工作 一 段 时 间 后 ,这 些 
文件 的 状态 可 能 是 未 修改 、 已 修改 或 已 放 入 暂 存 区 . 


本 地 文件 提交 到 远程 仓库 一 般 的 流程 为 : 
添加 文件 跟踪 一 > 暂 存 已 修改 的 文件 一 > 提交 到 本 地 仓库 一 > 推送 到 远程 仓库 . 


本 节 我 们 讲 添加 文件 跟踪 和 暂 存 已 修改 的 文件 . 


一 . 添加 文件 跟踪 
如 果 我 们 新 建 了 一 个 文件 ,默认 是 没有 被 跟踪 的 ,git 就 不 会 跟踪 文件 的 变更 , 那 如 何 跟踪 文件 呢 ? 
举 个 例子 : 


在 Android Studio 中 新 建 一 个 文件 DemoJjava, 然后 就 会 弹出 一 个 对 话 框 ,来 询问 你 是 否 要 将 此 文 
件 添 加 到 Git. 


点 击 [Yes] 此 文件 就 被 跟踪 了 . 


上 面 的 这 个 方法 很 方便 在 你 新 建 一 个 文件 的 时 候 就 提示 你 进行 文件 跟踪 ,但 如 果 你 用 别 的 方式 
新 建文 件 , 那 怎 么 样 添加 跟踪 呢 ? 


举 个 例子 : 

我 们 通过 命令 新 建 一 个 文件 Demo.java, 请 注意 ,文件 不 同 的 状态 都 有 不 同 的 颜色 来 表示 . 
1. 未 跟踪 的 文件 显示 为 红色 

那 我 们 如 何 将 Demo 添 加 到 跟踪 呢 ? 

右 击 Demo 文 件 或 在 Demo 文 件 编辑 区 右 击 一 > Git 一 > Add 

或 者 点 击 菜单 栏 一 > VCS 一 > Git 一 > Add 

添加 完成 后 ,Demo 文 件 颜色 变 为 了 绿色 ,所 以 


2. 已 跟踪 的 文件 显示 为 绿色 


3. 提 交 到 本 地 仓库 VW 远程 仓库 的 文件 颜色 显示 为 白色 


4. 已 修改 的 文件 显示 为 蓝 色 


二 . 暂 存 已 修改 的 文件 

暂 存 已 修改 的 文件 方法 同 添加 文件 跟踪 . 

所 以 add 功 能 可 以 用 来 跟踪 新 文件 ， 或 者 把 已 跟踪 的 文件 放 到 暂 存 区 ， 还 能 用 于 合并 时 把 有 冲 
突 的 文件 标记 为 已 解决 状态 等 ,我 们 可 以 将 这 个 功能 理解 为 “添加 内 容 到 下 一 次 提交 

不 过 如 果 想 提交 起 来 更 简单 ,可 以 直接 使 用 commit 命 令 , 在 提交 配置 列表 里 可 以 选择 已 修改 的 文 
件 和 新 添加 的 文件 ,在 commit 之 前 会 自动 add 选 中 的 文件 。 
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Git 提 交 变 更 
当 本 地 文件 变更 以 后 ,可 以 通过 VCS 一 > Git 一 > Commit File 弹出 提交 变更 窗口 


当然 ,分 支 合并 过 后 也 会 弹出 提交 变更 窗口 . 


提交 变更 窗口 中 你 可 以 选择 Change list, 也 可 以 选择 要 提交 的 变更 文件 ,默认 是 全 选 的 . 


在 Author 中 选择 或 者 输入 作者 名 字 . 选 择 Amend commit( 修 订 提 交 ) 会 在 Commit Message 中 添 
加 上 一 次 的 提交 信息 


在 提交 之 前 ,你 还 可 以 选择 做 一 些 代 码 优化 的 工作 ,比如 : Reformat code( 格 式 化 代码 )、 
Rearrage code( 重 新 排列 代码 )\ Optimize imports( 优 化 导入 )、Perform code analysis( 执 行 代 
码 分 析 )、Check TODO( 检 查 待 办 事项 )、Cleanup( 清 理 )、Update copyright( 更 新 版 权 声 明 ). 


点 击 某 个 变更 的 文件 ,在 Details 中 会 显示 本 地 和 远程 的 对 比 . 


提交 变更 
当 配置 好 提交 信息 以 后 ,将 鼠标 放 到 Commit 上 面 ,会 弹出 提交 操作 列表 ， 


Commit and Push: 将 本 地 变更 的 文件 提交 到 本 地 仓库 ,然后 推 到 远程 仓库 .Create Patch: 将 本 
地 变更 的 文件 作为 补丁 创建 .Commit: 将 本 地 变更 的 文件 提交 到 本 地 仓库 . 


这 里 我 选择 Commit and Push : 
如 果 你 选择 了 提交 之 前 进行 一 些 代码 检查 或 优化 ,会 先 执 行 优化 . 


如 果 点 击 Review 可 以 查看 代码 分 析出 来 的 问题 ,查看 以 后 觉得 没 问 题 ,重复 上 面 的 操作 (Android 
Studio 会 有 记录 ) 


如 果 点 击 Commit 会 直接 提交 . 
Commit 成 功 后 会 提示 Push 到 远程 仓库 . 
Æ 


默认 提交 到 当前 分 支 ， 你 也 可 以 选择 其 它 分 支 . 
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如 果 你 想 查 看 某 个 文件 的 某 是 谁 修改 的 ,可 以 使 用 文件 和 逐 行 追溯 功能 


执行 文件 逐 行 追溯 操作 ,会 ee ， 也 可 以 说 是 每 一 行 的 注释 , 注 
释 包 括 修订 版 本 号 、 提 交 者 、 提 交 日 期 以 及 提交 次 数 . 


如 何 进行 文件 逐 行 追溯 ? 
其 实 就 是 执行 git annotate 命 令 , 同 git blame. 
在 Android Studio 中 执行 annotate 的 操作 路 径 有 下 面 这 几 个 
方法 一 : 右 击 文件 左边 状态 栏 一 > 选择 Annotate 
方法 二 : 右 文件 编 缉 区 域 一 > A Git 一 > 选择 Annotate 
方法 三 : 菜单 栏 一 > 点 击 VCS 一 > 选择 Annotate 
选择 Annotate 后 会 显示 文件 每 一 行 的 注释 ,注释 如 下 : 
文件 中 每 一 行 的 注释 包括 修订 版 本 号 、 提 交 者 、 提 交 日 期 以 及 提交 次 数 . 
如 果 你 想 追 溯 某 一 行 的 改动 ,点 击 这 一 行 的 注释 ,会 弹出 那 次 提交 的 改动 文件 列表 以 及 提交 信息 . 


因此 如 果 你 想 在 进行 逐 行 追 湖 的 时 候 省 点 力气 ,或 者 让 review 代 码 的 人 轻松 一 点 , 那 就 要 注意 
每 次 提 次 不 要 改动 太 多 文件 ,提交 信息 (commit message) 一 定 要 写 清楚 改动 的 目的 以 及 影响 点 ， 
这 些 可 以 写 到 团队 协作 规范 里 . 


显示 当前 修订 版 本 


修订 版 本 号 (revision) 是 一 组 SHA-1 值 ,我 们 可 以 通过 SHA-1 值 来 获取 对 应 的 那 一 次 提交 


tips: SHA-1 是 散 列 函数 加 密 算 法 , 输出 的 散 列 值 为 40 位 十 六 进 制 数字 串 , 可 用 于 验证 信息 
的 一 致 性 ,防止 被 自 改 . 


android studio 中 显示 当前 修订 版 本 的 操作 步骤 是 
右 击 某 一 个 文件 或 在 文件 编辑 区 右 击 一 > Git 一 > Show Current Revision 


或 者 点 击 菜单 栏 一 > VCS—> Git 一 > Show Current Revision 


Git 文 件 比 较 

Android Studio 集 成 的 Git 提 供 了 丰富 的 文件 比较 功能 ,我 们 可 以 将 本 地 文件 与 远程 仓库 中 的 、 
某 次 提交 的 或 其 它 分 支 的 文件 进行 比较 . 

可 以 通过 如 下 操作 方法 使 用 比较 功能 : 

方法 一 : 右 击 某 一 个 文件 或 右 击 文件 的 编辑 区 一 > Git. 

方法 二 : 菜单 栏 一 > VCS 一 > Git 

方法 三 : Version Control 一 > 右 击 有 变更 的 文件 一 > Git 

比较 功能 有 下 面 这 几 个 : 

Compare with the Same Repository Version: 比 校本 地 文件 与 远程 仓库 的 文件 

Compare with Latest Repository Version: 本 地 文件 与 最 近 的 一 次 提交 比较 

Compare with: 本 地 文件 与 某 一 次 提交 比较 

Compare with Branch: 本 地 的 文件 或 文件 夹 与 茶 个 分 支 上 的 进行 比较 . 

接 下 来 我 们 来 介绍 一 下 这 几 个 功能 . 

比 校 本 地 文件 与 远程 仓库 的 文件 

如 果 本 地 某 一 个 文件 被 修改 了 ,我 们 想 查 看 它 与 远程 仓库 中 的 文件 有 什么 不 同 ,就 需要 比较 一 下 . 
比较 方法 : 

右 击 茶 一 个 文件 或 右 击 文件 的 编辑 区 一 > Git 一 > Compare with the Same Repository Version 
本 地 文件 与 提交 的 版 本 进行 比较 

Compare with Latest Repository Version: 本 地 文件 与 最 近 的 一 次 提交 比较 


Compare with: 本 地 文件 与 某 一 次 提交 比较 ,点 击 此 选项 会 显示 文件 的 提交 列表 ,可 选择 某 一 次 
提交 进行 比较 . 


前 面 讲 的 几 个 比较 功能 都 是 同一 个 分 支 上 的 文件 的 比较 , 那 如 果 想 跟 其 它 分 支 上 的 文件 或 文件 
夹 进行 比较 应 该 怎么 办 呢 ? 


比较 不 同 分 支 的 文件 或 文件 夹 


Compare with Branch: 本 地 文件 或 文件 夹 与 茶 个 分 支 上 的 进行 比较 . 


Git 文 件 比 较 
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Git 撤 销 操作 


如 果 你 对 某 个 或 某 几 个 文件 进行 了 修改 ,现在 想 撤销 这 


这 


侈 改 , 应 该 怎么 办 呢 ? 
请 使 用 Git 提 供 的 撤销 操作 功能 
如 下 图 所 示 ,Android Studio 中 提供 了 多 个 快捷 操作 方式 ,可 以 方便 的 撤销 操作 . 


确认 Revert 后 ,被 选中 的 文件 就 恢复 到 了 改动 之 前 的 状态 . 


Githk AB 


Git 版 本 回 退 的 意思 就 是 将 本 地 代码 回 退 到 某 一 个 指定 的 版 本 ,此 版 本 之 前 的 所 有 内 容 都 会 被 重 
置 . 


操作 方法 : 

VCS 一 > Git 一 > Reset HEAD—> 弹出 Reset Head 对 话 框 . 
Reset HEAD : 

Reset Type: 回 退 类 型 


Mixed : 回 退 到 某 个 版 本 ,本 地 源码 不 会 回 退 , 会 回 退 commit 和 index 信 息 . 


Soft : 回 退 到 某 个 版 本 , 本 地 源码 和 index 信 息 不 会 回 退 , 只 回 退 了 commit 的 信息 ,如 果 还 要 提 
交 ， 直 接 commit 即 可 . 


Hard : 彻底 回 退 到 某 个 版 本 ， 本 地 的 源码 也 会 变 为 某 个 版 本 的 内 容 . 
To Commit: 回 退 版 本 

在 To Commit 中 配置 要 回 退 到 哪个 版 本 ,默认 是 HEAD. 

HEAD: 回 退 到 最 近 一 个 提交 版 本 . 

HEADA^: 回 退 到 上 一 个 提交 版 本 . 

HEAD: 回 退 到 上 上 一 个 提交 版 本 . 

... 依 此 类 推 . 

也 可 以 使 用 另外 一 种 方式 回 退 版 本 : 
HEAD~0: 回 退 到 最 近 一 个 提交 版 本 . 
HEAD~1: 回 退 到 最 近 一 个 提交 版 本 . 
HEAD~2: 回 退 到 最 近 一 个 提交 版 本 . 

... 依 此 类 推 . 

Validate: 版 本 验证 

在 指定 回 退 到 某 个 版 本 之 前 你 也 可 以 先 验 证 一 下 是 否 是 你 想 回 退 的 版 本 . 


确认 后 点 [ Reset ] 就 可 以 回 退 到 指定 的 版 本 了 . 


Git 版 本 回 退 
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Git 查 看 提交 历史 


我 们 在 13.6 节 介绍 过 了 【查看 本 地 变更 历史 】, 在 这 一 节 我 们 介绍 Git 查 看 提交 历史 记录 功能 . 


跟 本 地 变更 历史 提供 的 功能 相同 ,Git 查 看 提交 历史 记录 也 都 有 查看 文件 、 文 件 夹 和 代码 段 的 历 
史记 录 功 能 ， 不 同 点 在 于 【查看 本 地 变更 历史 】 仅 能 查看 本 地 的 变更 ,远程 的 改动 是 无 法 看 到 
的 ,【Git 查 看 历史 记录 】 可 以 查看 所 有 commit 以 后 的 历史 . 


因此 当 你 想 查 看 某 个 文件 或 文件 夹 提 交 的 历史 记录 的 时 候 ,可 以 使 用 此 功能 . 
一 . 查看 某 个 文件 的 提交 历史 

前 题 条 件 : 

在 文件 列表 中 选中 此 文件 或 打开 此 文件 ,光标 在 文件 中 . 


操作 步骤 : 
点 击 右键 一 > 在 弹出 的 操作 选项 中 点 击 Git 一 > Show History 一 > Show History 


然后 会 在 Version Control 中 显示 History 


二 . 查看 某 段 代码 的 提交 历史 


如 果 你 想 查 看 某 段 代码 提交 历史 记录 ， 需 要 先 选中 这 段 代 码 , 然 后 在 Git 操 作 列表 中 选择 [Show 
History for Selection] 


什么 是 分 支 9 
当 我 们 在 进行 软件 开发 时 , 同一 个 软件 多 个 人 协同 开发 ,因此 要 有 不 同 的 分 工 ,如 果 想 让 彼此 的 
代码 不 受 影 响 , 那 就 需要 在 不 同 的 分 支 上 进行 开发 ,开发 完成 后 再 进 地 合并 . 


分 支 可 以 理解 为 一 个 主干 衍生 出 来 的 支 干 ,我 们 可 以 在 这 些 支 干 上 修改 代码 , 且 彼 此 不 受 影响 ,这 
样 做 的 好 处 就 是 在 同一 个 数据 库 里 可 以 同时 进行 多 个 修改 ,最 终 会 合并 到 一 


Android Studio 中 Git 的 分 支管 理 特别 方便 ,我 们 可 以 通过 Git 操 作 列 表 中 的 branchs 或 状态 栏 的 
分 支管 理 来 对 本 地 或 远程 的 分 支 进行 各 种 操作 , 像 检 出 、 创 建新 的 分 支 、 对 比 、 合 并 、 删 除 等 . 


如 上 图 ,Local Branches 列 出 了 本 地 所 有 的 分 支 , 这 些 eo oe 了 远程 仓 
库 ,Remote Branches 列 出 了 所 有 的 远程 仓库 中 的 分 


新 建 分 支 


点 击 [New Branch] 一 > 输入 分 支 的 名 字 一 > OK 


检 出 分 支 
出 分 支 作为 新 的 本 地 分 支 ,意思 就 是 你 可 以 把 一 个 远程 分 支 checkout 下 来 ,可 以 起 不 同 的 名 字 ， 
个 本 地 分 支 ,但 是 提交 时 都 是 向 同一 个 远程 分 支 进行 提交 . 
操作 步 又: 
选择 一 个 分 支 (远程 或 本 地 分 支 ) 一 > 点 击 [Checkout as new local branch] 
如 果 是 远程 分 支 会 默认 使 用 远程 分 支 名 作为 本 地 分 支 名 . 
但 如 果 本 地 已 经 有 了 这 个 分 支 名 ,会 提示 你 重 命 
输入 新 的 分 支 名 一 > OK 一 > 成 功 检 出 . 


如 果 你 是 对 本 地 分 支 进 行 [Checkout as new local branch] 操 作 , 会 直接 弹出 一 个 [Checkout 
New Branch] 输 入 框 ,不 会 有 默认 的 分 支 名 . 


检 出 分 支 V 标 签 VY 修订 版 本 


ho KANT Hk HE 个 分 支 V 标 签 V 修 订 版 本 ,只 JN 需要 知道 首 对 应 的 名 字 就 可 以 . 


在 Git Branches 操 作 列 表 中 选择 [Checkout Tag or Revision] 一 > 在 弹出 的 输入 框 中 输入 分 支 名 
一 > OK 后 会 检 出 应 的 分 支 . 


检 出 tag 也 只 需要 输入 tag 名 就 可 以 了 ,如 果 检 出 当前 分 支 的 某 个 修订 版 本 需要 输入 对 应 的 修订 
版 本 号 . 


切换 分 支 
切换 分 支 需要 选择 要 切换 的 分 支 , 点 击 [Check out] 


如 果 你 原来 的 分 支 没有 变更 ,checkout 后 会 切换 到 新 的 分 支 ,如 果 有 变更 且 有 冲突 ,会 先 让 你 解决 
冲突 然后 再 切换 . 


2 


分 支 对 比 


分 支 对 比 是 拿 当 前 分 支 与 另外 一 个 分 支 (本 地 或 远程 ) 进 行 对 比 
对 比 两 个 分 支 的 提交 日 志 


对 比 两 个 分 支 的 不 同 


BHA L 
合并 分 支 只 将 选中 的 分 支 与 当前 的 分 支 进行 合并 


如 果 有 冲突 会 弹出 冲突 列表 ,解决 冲突 后 可 合并 成 功 ,合并 冲突 请 参考 13.17 节 . 


删除 分 支 


删除 本 地 分 支 :本 地 分 支 会 被 直接 删除 


删除 远程 分 支 : 删除 远程 分 支 会 有 确认 是 否 删除 ,确认 删除 后 状态 栏 会 有 正在 删除 的 信息 显示 
删除 成 功 后 Version Control 上 会 有 删除 成 功 提 示 ,Remote Branches 列 表 中 此 分 支 也 会 消 Pe 


提交 分 支 就 是 将 本 地 Push 到 远程 仓库 


Git 分 支管 理 
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Git 创 建 标 签 


Git 可 以 给 历史 中 的 某 一 个 修订 版 本 打上 标签 , 通 


tee I 
VCS 一 > Git 一 >Tag 一 > 弹出 创建 标 


配置 介绍 


Git Root: 项 目地 址 
Current Branch: 显示 当前 的 分 支 


Tag Name: 标签 名 


示 签 配置 窗 


Q 


常 我 们 会 使 用 标签 来 表示 一 个 版 本 的 发 布 . 


Force: 如 果 相 同 的 tag 名 已 经 存在 了 ,是 否 强 制 创 建 . 


,如 果 空 白 默 认 对 HEAD 打 标签 . 


Commit: 通过 输入 的 修订 版 本 号 、tag 名 来 打 标 签 

Create Tag: 

另外 我 们 还 可 以 在 Version Control 中 , 右 击 某 个 提交 信息 然后 创建 标签. 
本 地 创建 标签 成 功 以 后 ,push 到 远程 仓库 就 可 以 了 . 
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1% a Android Studio 的 主题 


1% & Android Studio 的 字体 和 大 小 


EKAE LRARKA 


调整 演示 模式 的 字体 大 小 


菜单 和 工具 栏 


对 菜单 选项 和 工具 栏 的 工具 进行 增删 改 


1% a Je # Android Studio 时 是否 自动 打开 项 目 


1% @ 2B E Android Studio 时 是 否 弹 出 确认 提示 


设置 打开 一 个 项 目 时 的 打开 方式 


设置 文件 自动 保存 的 时 间 


E OD TF fik RO 


设置 HTTP 代 理 


1% @ Android Studio 版 本 更 新 规则 


设置 是 否 让 Google 统 计 你 的 使 用 信息 


& 32 Android SDK 平 台 


使 用 单独 的 SDK 管 理 窗 口 来 管理 SDK 


管理 Android SDK 开 发 工具 


® 32 Android SDK 更 新 站 点 


文件 磊 色 


Android Studio 中 使 用 Eclipse 快捷 键 


自 定 义 keymap 


设置 点 击 编辑 器 光标 定位 在 一 行 的 结尾 或 定位 
在 点 击 的 位 置 


目 动 换行 


设置 粘贴 历史 记录 的 个 数 


1G RUC AT APM A hg 4S aR 


设置 粘 帖 时 自动 导入 包 


TB eG HE EA GE 


置 外 观 


设置 代码 补 全 


设置 自动 补 全 时 是 否 区 分 大 小 写 


加 快 目 动弹 出 代码 补 全 提示 的 速度 


关闭 目 动弹 出 代码 补 全 提示 


看 方法 参数 信息 的 时 候 显 示 方 法 签名 


TE Ag a E 


设置 控制 台 


设置 用 星 号 标记 修改 过 的 文件 标签 


设置 打开 的 文件 标签 可 以 多 行 显 示 


设置 打开 的 文件 标签 超过 一 定数 重 时 的 关闭 规 
则 


开局 使 用 驼峰 单词 


BR E40 FR 


切换 编辑 器 配色 方案 


为 编辑 器 添加 自足 义 配 色 方 委 


设置 代码 的 字体 和 大 小 


显示 条 标 和 条 标的 显示 磊 色 


eS Ay el 
设置 控制 台 的 颜色 


第 四 部 分 插件 


Dy 


$% 


k 


0 
局 


五 


> 


分 版 本 控制 


` 


六 部 分 43S GUT oh 


构建 工具 


设置 开启 Gradle 离 线 工 作 模式 


编译 设置 目 动 编译 项 目 


调整 编译 内 存 大 小 


第 十 六 章 插件 


Google 在 2013 年 5 月 的 IVO 开 发 者 大 会 推出 了 基于 Intellij IDEA Java IDE 上 的 Android 
Studio。AndroidStudio 是 一 个 功能 齐全 的 开发 工具 ， 还 提供 了 第 三 方 插件 的 支持 。 让 开发 人 
员 更 快速 更 好 的 开发 程序 。 


插件 下 载 安 装 


e in Android Studio: go to File > Settings > Plugins > Browse repositories and search 
for 插件 名 


或 者 


e in Android Studio: go to download it jar and install File -~ Settings > Plugins > Install 


plugin from disk 


nS 
rf 


用 插件 


数据 来 源 : https://github.com/dreamlivemeng/androidstudio-plugins 


1. 


Android ButterKnife Zelezny ButterKnife 是 一 个 专注 于 Android 系 统 的 View 注 入 框架 ,可 以 
减少 大 量 的 findViewByld 以 及 setOnClickListener 人 代码， 可 视 化 一 键 生成 。 玫 天 PS: 效 果 
图 就 不 贴 了 ， 打 开 插 件 下 载 地 址 和 源码 地 址 都 能 看 见 ， 而 且 数 据 多 了 加 载 效果 图 蛮 卡 
的 。 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7369?pr=androidstudio 插件 源 
码 地 址 : https://github.com/avast/android-butterknife-zelezny 插件 教 

程 : http://blog.csdn.net/dreamlivemeng/article/details/51261170 推荐 指数 : AE 


GsonFormat GsonFormat 是 一 个 快速 格式 化 json 数 据 , 自 动 生成 实体 类 参数 的 插件 。 插件 
下 载 地 址 : https://plugins.jetbrains.com/plugin/7654?3pr=androidstudio 插件 源码 地 

址 : https://github.com/zzz40500/GsonFormat 插件 教 

程 : http://blog.csdn.net/dreamlivemeng/article/details/51262538 推荐 指数 : OE 


Android Drawable Importer 为 了 适应 所 有 Android 屏 幕 的 大 小 和 密度 ， 每 个 Android 项 目 
都 会 包含 drawable 文 件 夹 。 任 何 具备 Android 开 发 经 验 的 开发 人 员 都 知道 ， 为 了 支持 所 有 
的 屏幕 尺寸 ， 你 必须 给 每 个 屏幕 类 型 导入 不 同 的 画板 。Android Drawable Importer 插 件 
能 让 这 项 工作 变 得 更 容易 。 它 可 以 减少 导入 缩放 图 像 到 Android 项 目 所 需 的 工作 量 。 
Android Drawable Importer 添 加 了 一 个 在 不 同 分 辩 举 导入 画板 或 缩放 指定 图 像 到 定义 分 
辨 率 的 选项 。 这 个 插件 加 速 了 开发 人 员 的 画板 工作 。 插件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/7658?pr=androidstudio 插件 源码 地 

址 : https://github.com/winterDroid/android-drawable-importer-intellij-plugin 插件 教程 地 
址 : http://blog.csdn.net/lee_sire/article/details/49684385 推荐 指数 : 三 星 


android-selector-chapek / SelectorChapek for Android 根据 资源 自动 生成 相应 的 
selector。 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7298 插件 源码 地 
址 : https://github.com/inmite/android-selector-chapek 推荐 指数 : 四 星 


Android Parcelable code generator 快速 实现 Parcelable 接 口 的 插件 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7332?pr= 插件 源码 地 

址 : https://github.com/mcharmas/android-parcelable-intellij-plugin/ 插件 教程 地 
址 : http://blog.csdn.net/kroclin/article/details/40902721 推荐 指数 : 四 星 


Markdown supportMarkdown 是 一 种 可 以 使 用 普通 文本 编辑 器 编写 的 标记 语言 ， 通 过 类 
似 HTML 的 标记 语法 ， 它 可 以 使 普通 文本 内 容 具有 一 定 的 格式 。 插件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/7793 插件 文档 地 

址 : https://github.com/JetBrains/intellij-plugins/tree/master/markdown 推荐 指数 : 四 星 


10. 


11. 


12. 


13. 


14. 


15. 


16. 


. Markdown Navigator— #Markdowndé& # > 2ehttps://github.com/nicoulaj/idea-markdown 


他 的 一 个 分 支 ， 但 是 主 项 目 由 于 维护 的 原因 已 经 从 jetbrains 中 删除 了 ， 如 果 想 了 解 主 项 目 
的 也 可 以 通过 上 面 的 github 地 址 进行 了 解 。 插 件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/7896 ?pr= 插件 源码 地 

址 : https://github.com/vsch/idea-multimarkdown 推荐 指数 : 四 星 


. Android Postfix completion 可 根据 后 级 快速 完成 代码 。 插件 下 载 地 


址 : https://plugins.jetbrains.com/plugin/7775?pr= 插件 教程 地 
址 : http://blog.jetbrains.com/idea/2014/03/postfix-completion/ 推荐 指数 : AE 


. AndroidAccessors 快速 实现 get 和 set 方 法 的 插件 。 插 件 下 载 地 


址 : https://plugins.jetbrains.com/plugin/7496?pr= 插件 文档 地 
址 : https://github.com/jonstaff/AndroidAccessors 推荐 指数 : 三 星 


Lifecycle Sorter 可 以 根据 Activity 或 者 fragment 的 生命 周期 对 其 生命 周期 方法 位 置 进行 先 
后 排序 。 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7742?pr= 插件 源码 地 
址 : https://github.com/armandAkop/Lifecycle-Sorter 推荐 指数 : RE 


ADB WIFI 无 需 root 就 能 wifi 调试 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7856?pr= 插件 源码 地 
址 : https://github.com/layerlre/ADBWIFI 推荐 指数 ; RE 


ADB Idea adb 调试 工具 ,Uninstall App ` Kill App ` Start App ` Restart App ` Clear App 
Data ` Clear App Data and Restart 插 件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/7380?pr= 插件 源码 地 

址 : https://github.com/pbreault/adb-idea/ 推荐 指数 : AE 


Android WiFiADB 无 线 调 试 应 用 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7983 插件 源码 地 
址 : https://github.com/pedrovgs/AndroidWiFiADB 推荐 指数 : 五 星 


CodeGlance 最 大 的 用 途 : 可 用 于 快速 定位 代码 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7275?pr= 插件 源码 地 址 : 
https://github.com/Vektah/CodeGlance 推荐 指数 : AE 


=, 


JSONOnlineViewer 可 实现 直接 在 android studio 中 调试 接口 数据 ， 可 以 选择 请 求 类 型 ， 
自 定义 请 求 头 及 请 求 体 ，json 数 据 格式 化 后 展示 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7838?pr= 推荐 指数 : 四 星 


FindBugs-IDEA 通过 FindBugs 帮 你 找到 隐藏 的 bug 及 不 好 的 做 法 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/3847 ?pr= 插件 源码 地 

址 : https://github.com/andrepdo/findbugs-idea/tree/master 插件 教程 地 

址 : http://blog.csdn.net/fancy_xty/article/details/51718687 推荐 指数 : 四 星 


17. 


18. 


19. 


20. 


21. 


22. 


23. 


24. 


25. 


26. 


jimu Mirror 这 是 一 个 可 以 让 你 在 丨 实 的 设备 上 迅速 测试 布局 的 插件 。jimu Mirror 人 允许 在 设 
备 上 预览 随同 编码 更 新 的 Android 布 局 。 插 件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/7517 ?pr= 插件 教程 地 

址 : http://www.itnose.net/detail/6204426.html 推荐 指数 : 四 星 


JavaDoc 添加 注释 ， 可 自 定义 模板 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/?idea_ce&pluginld=7157 插件 源码 地 
址 : https://github.com/setial/intellij-javadocs 推荐 指数 : RE 


Android strings.xml tools 可 以 用 来 管理 Android 项 目 中 的 字符 串 资 源 。 它 提供 了 排序 
Android 本 地 文件 和 添加 缺少 的 字符 串 的 基本 操作 。 虽 然 这 个 插件 是 有 限制 的 ， 但 如 果 应 
用 程序 有 大 量 的 字符 串 资 源 ， 那 这 个 插件 就 非常 有 用 了 。 插件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/7498?pr= 插件 源码 地 

址 : https://github.com/constantine-ivanov/strings-xml-tools 推荐 指数 : 五 星 


Robotium Recorder Robotium Recorder 是 一 个 自动 化 测试 框架 ， 用 于 测试 在 模拟 器 和 
Android 设 备 上 原生 的 和 混合 的 移动 应 用 程序 。Robotium Recorder 可 以 让 你 记录 测试 案 
例 和 用 户 操作 。 你 也 可 以 查看 不 同 Android 活 动 时 的 系统 功能 和 用 户 测试 场景 。 插件 下 载 
地 址 : https://plugins.jetbrains.com/plugin/7513?pr= 插件 官方 网 

dE : http://robotium.com/ 推荐 指数 : 四 星 


Android Holo Colors Generator 通过 自 定义 Holo 主 题 颜色 生成 对 应 的 Drawable 和 布局 文 
件 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7366?pr= 插件 源码 地 
址 : https://github.com/jeromevdl/android-holo-colors-idea-plugin 推荐 指数 : 四 星 


lint-cleaner-plugin 删除 未 使 用 的 资源 ,包括 String 字 符 串 ,颜色 和 尺寸 。 这 是 一 个 Gradle 插 
件 ， 所 以 如 何 配置 可 以 去 github 的 源码 上 看 。 插件 源码 地 
址 : https://github.com/marcoRS/lint-cleaner-plugin 推荐 指数 : 四 星 


codota 该 网 站 搜集 了 大 量 的 代码 ， 号 称 超过 700W 的 代码 实例 。 提 供 了 chrome 和 as 插 
件 。 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7638?pr= 插件 官方 网 
址 : https://www.codota.com/ 推荐 指数 : RE 


ECTranslation 一 个 androidstudio 上 面 的 翻译 插件 〈 将 英文 翻译 为 中 文 ) 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/8469 插件 源码 地 
址 : https://github.com/Skykai521/ECTranslation 推荐 指数 : 四 星 


TranslationPlugin Android Studio/Intellid IDEA 翻译 插件 ,可 中 英 互 译 。 暂 时 以 jar 方 式 安 
装 。 插件 源码 地 址 : https://github.com/YiiGuxing/TranslationPlugin 推荐 指数 : 三 星 


Android File Grouping Plugin 该 插件 可 自动 将 前 级 相同 的 文件 归 类 显示 到 同一 文件 目录 
下 ， 但 不 会 因此 而 移动 文件 或 创建 文件 夹 。 插件 下 载 地 

址 : https://github.com/dmytrodanylyk/folding-plugin/releases 插件 源码 地 

址 : https://github.com/dmytrodanylyk/folding-plugin 推荐 指数 : 四 星 


27. PermissionsDispatcher 一 个 针对 API 23， 可 在 activity/Fragment 中 快速 生成 Runtime 
Permissions 代码 的 播 件 。 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/8349 插件 
源码 地 址 : https://github.com/shiraji/permissions-dispatcher-plugin 推荐 指数 ; 四 星 


28. Android code Generator Android Studio/lntelliJ IDEA 的 安 卓 代码 生成 插件 ， 帮 助 提高 app 
的 开发 速度 。 可 以 从 layout 生 成 Activity 类 、Fragment 类 、Adapter 类 ， 从 menu.xml 生 成 
menu 代 码 等 。 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7595?pr= 插件 源码 地 
址 : https://github.com/tmorcinek/android-codegenerator-plugin-intellij 插件 教程 : (中 
文 版 ) http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2016/0523/4294.html、 

(美文 版 ) http://tmorcinek.github.io/android-codegenerator-plugin-intellij/ 推荐 指数 : 五 
星 


29. .ignore 项 目 中 ， 每 次 add，commit 的 时 候 有 可 能 会 把 Module 生 成 的 一 些 build 文 件 /本 地 配 
置 文件 /iml 文 件 提 交 上 去 。 可 以 通过 gitignore 解 决 ， 如 果 你 不 想 提交 的 文件 ， 就 可 以 在 创 
建 项 目的 时 候 将 这 个 文件 中 添加 即 可 ， 将 一 些 通用 的 东西 屏蔽 掉 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7495?pr=androidstudio 插件 源码 地 
址 : https://github.com/hsz/idea-gitignore 推荐 指数 : 四 星 


30. checkstyle-idea CheckStyle-IDEA 是 一 个 检查 代码 风格 的 插件 ， 比 如 像 命名 约定 ， 
Javadoc， 类 设计 等 方面 进行 代码 规范 和 风格 的 检查 ， 你 们 可 以 遵从 像 Google Oracle 的 
Java 代码 指南 ， 当 然 也 可 以 按照 自己 的 规则 来 设置 配置 文件 ， 从 而 有 效 约束 你 自己 更 好 
地 遵循 代码 编写 规范 。 插 件 下 载 地 址 : https://plugins.jetbrains.com/plugin/1065? 
pr=androidstudio 插件 源码 地 址 : https://github.com/jshiell/checkstyle-idea 推荐 指数 : 四 
星 


31. Android Methods Count 统计 Android 依 赖 库 中 方法 的 总 个 数 。 (一 个 dex 只 能 接受 的 65K 
并 不 是 指 方法 数 超过 65K 而 报 的 错 ,而 是 指引 用 计数 超过 65K) 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/8076?pr=androidstudio 推荐 指数 : 四 星 


32. Sexy Editor 设置 代码 性 感 背景 图 ， 还 是 比较 强悍 的 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/1833?pr=androidstudio 插件 源码 地 
址 : https://github.com/igorspasic/idea-sexyeditor 推荐 指数 : RE 


33. AndroidProguardPlugin Android 一 键 生成 项 目 混 淆 代码 插件 ， 现 在 jetbrains 还 在 审核 只 能 
下 载 进行 安装 了 ， 不 能 通过 as 插件 直接 搜索 安装 。 因 为 混淆 时 很 多 同学 比较 头 疫 的 一 个 
事情 ， 所 以 给 5 星 。 插件 下 载 地 
址 : https://raw.githubusercontent.com/zhonghanwen/AndroidProguardPlugin/master/An 
droidProguard.zip 插件 源码 地 
址 : https://github.com/zhonghanwen/AndroidProguardPlugin 推荐 指数 : 五 星 


34. Android Studio Prettify 从 布局 文件 一 键 生成 对 view 的 声明 (不 适用 注解 ， 形 式 为 
findviewByld 的 方式 ) ,还 可 以 将 代码 中 的 字符 串 写 在 String.xml 文 件 中 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7405 插件 源码 地 
址 : https://github.com/Haehnchen/idea-android-studio-plugin 推荐 指数 : 四 星 


35. 


36. 


37. 


38. 


39. 


40. 


41. 


42. 


43. 


44. 


Gradle Dependencies Helper Maven gradle 依 赖 自 动 补 全 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7299 插件 源码 地 
址 : https://github.com/siosio/GradleDependenciesHelperPlugin 推荐 指数 ; 五 星 


Remove ButterKnife ButterKnife 这 个 第 三 方 库 每 次 更 新 之 后 ， 绑 定 view 的 注解 都 会 改 

变 ， 从 bind, 到 inject， 再 到 bindview， 一 旦 升级 ， 就 会 有 巨 量 的 代码 需要 手动 修改 ,所 以 这 
个 插件 可 以 快速 移 除 ， 将 注解 代码 变 成 findviewbyld 的 形式 。 插件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/8432 插件 源码 地 

址 : https://github.com/u3shadow/RemoveButterKnife 插件 教程 地 

址 : https://github.com/u3shadow/RemoveButterKnife/blob/master/README.md 推荐 指 
数 : 三 星 


Android DPI Calculator Dpi 计 算 插 件 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7832 插件 源码 地 
址 : https://github.com/JerzyPuchalski/Android-DPI-Calculator 推荐 指数 : AZ 


SingletonTest 快速 生成 单 例 模式 的 插件 。 单 例 模式 的 六 种 生成 方式 
LazyUnSafe,LazySafe,Hungry, DoubleCheck, Staticinner,Enum(http://cantellow.iteye.co 
m/blog/838473); 插 件 需 要 从 github 中 下 载 jar 安 装 。 插件 源码 地 

址 : https://github.com/luhaoaimama1/SingletonTest 推荐 指数 : 四 星 


Android Localizationer 将 项 目 中 的 string 资源 自动 翻译 为 其 他 语言 的 Android 
Studio/Intellid IDEA 插件 。 插 件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7629 插件 
源码 地 址 : https://github.com/westlinkin/AndroidLocalizationer 推荐 指数 : 四 星 


Material Theme UI 添加 Material 主 题 到 你 的 AS 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/8006?pr= 插件 源码 地 
址 : https://github.com/ChrisRM/material-theme-jetbrains 推荐 指数 : AZ 


gradle-retrolambda 在 java6,java7 中 也 能 使 用 Lambda 表 达 式 。 这 个 使 用 方式 跟 其 他 插件 
不 同 ， 使 用 方式 请 看 github 的 说 明 。 插件 源码 地 址 : https://github.com/evant/gradle- 
retrolambda 推荐 指数 : AE 


eventbus-intellij-plugin eventbus 导 航 插件 ， 方 便 快 速 查找 ， 但 是 有 2 个 pr 没 处 理 ， 已 经 有 
1 年 没 维护 更 新 了 。 插件 源码 地 址 : https://github.com/kgmyshin/eventbus-intellij-plugin 
推荐 指数 : 三 星 

otto-intellij-plugin otto 导 航 插件 ， 也 是 很 久 没 维护 了 ， 不 过 可 以 用 。 插件 源码 地 

址 : https://github.com/square/otto-intellij-plugin 推荐 指数 : 三 星 


dagger-intellij-plugin dagger 可 视 化 辅助 工具 插件 源码 地 
址 : https://github.com/square/dagger-intellij-plugin 推荐 指数 : 四 星 
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46. 


47. 


48. 


49. 


50. 


51. 


52. 


53. 


Android Styler 根据 Xml 文件 生成 style 文 件 的 插件 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7972 插件 源码 地 
址 : https://github.com/alexzaitsev/android-styler 推荐 指数 : 四 星 


ideavim 能 让 开发 使 用 vi， 大 大 提高 开发 效率 。 插件 下 载 地 
址 : https:/plugins.jetbrains.com/plugin/164?pr= 插件 源码 地 
址 : https://github.com/JetBrains/ideavim 推荐 指数 : RE 


Android Material Design Icon Generator 可 以 在 Android 项 目 中 设置 material design 样 式 
图 标 (material design icons) 插件 下 载 地 址 : httos://plugins.jetbrains.com/plugin/7647? 
pr= 插件 源码 地 址 : https://github.com/konifar/android-material-design-icon-generator- 
plugin 推荐 指数 : AE 


Gradle Killer Gradle 卡 死 可 以 用 这 个 插件 。 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7794 ?pr= 插件 源码 地 
址 : https://github.com/KanbanApps/GradleKillerldeaPlugin 推荐 指数 : RE 


android-toolbox-plugin 能 根据 xml 文 件 生成 对 应 的 ViewHolder 类 ， 可 以 是 findviewbyld 形 
式 或 者 是 ButterKnife 刀 形式 ， 如 果 你 使 用 ButterKnife。 插件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/7200 插件 源码 地 

址 : https://github.com/idamobile/android-toolbox-plugin 推荐 指数 : 三 星 


java2smali 能 快速 将 当前 java 文 件 编译 成 smali 文 件 ， 方 便 学 习 smali 语 法 的 童鞋 来 对 比 源 
码 学 习 。 插件 下 载 地 址 : https://plugins.jetbrains.com/plugin/7385 插件 源码 地 
址 : https://github.com/ollide/intellij-java2smali 推荐 指数 : 三 星 


PermissionsDispatcher plugin 自动 生成 android6.0 权 限 代 码 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/8349 插件 源码 地 
址 : https://github.com/shiraji/permissions-dispatcher-plugin 推荐 指数 : AE 


WakaTime 记录 你 在 IDE 上 工作 的 时 间 插件 下 载 地 
址 : https://plugins.jetbrains.com/plugin/7425 插件 源码 地 
址 : https://github.com/wakatime/jetbrains-wakatime 推荐 指数 : AE 


Exynap Exynap 是 一 个 帮助 你 快速 查找 和 完成 代码 插入 的 AndroidStudio 插 件 。 你 只 需 输 
入 一 个 命令 按 回 车 就 能 调 出 一 段 代码 ， 而 这 个 命令 也 不 需要 你 去 记 ， 只 需 输 入 大 致意 思 
就 可 以 了 ，Exynap 提 供 了 上 千 种 智能 代码 解决 方案 。 插件 下 载 地 

址 : https://plugins.jetbrains.com/plugin/8600?pr=idea 插件 主页 地 

址 : http://exynap.com/ 插件 教程 地 

址 : http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2016/0908/6606.html 推荐 
指数 : 五 星 


A 


常用 插件 
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插件 开发 


一 、 概 述 


相信 大 家 在 使 用 Android Studio 的 时 候 ， 或 多 或 少 的 会 使 用 一 些 插件 ， 适 当 的 配合 插件 可 以 帮 
助 我 们 提升 一 定 的 开发 效率 ， 更 加 快乐 。 例 如 : 


https:VVgithub.comVzzz40500VGsonFormat 可 以 帮助 我 们 从 Gson 转 化 为 实体 

类 https:VVgithub.comVavastVandroid-butterknife-zelezny 可 以 帮助 我 们 更 加 方便 的 使 用 
butterknifehttps:VVgithub.comVSkykai521VECTranslation 可 以 帮助 在 IDE 里 面 完 成 英文 -> 中 
文 的 翻译 


有 名 话 叫 做 授 人 以 鱼 不 如 授 人 以 渔 ， 不 能 一 直 跟 随 着 别人 的 脚步 去 使 用 插件 了 ， 有 必要 去 学 
习 编 写 插件 ， 当 自己 有 好 的 创意 的 时 候 ， 就 可 以 自己 实现 了 。So， 本 文 的 内 容 是 : 
自己 编写 一 个 Android Studio 插 件 
ok， 其 实 编写 插件 并 不 难 ， 官 方 也 有 详细 的 文档， 所 以 你 也 可 以 选择 直接 阅读 下 文学 习 : 
http:VVwww.jetbrains.orgVintellijVsdkVdocsVbasics\/getting_started.html 
为 了 文章 有 一 定 的 流畅 性 ， 决 定 以 ECTranslation 作 为 编写 Android Studio 插 件 的 例子 。 
我 为 什么 选 这 个 呢 ? 因为 创意 好 ， 实 用 并 且 代 码 简单 。 
贴 一 个 今天 这 个 插件 的 最 终 效果 图 : 
局 Aciviyjavax| 

* knows 1t needs to keep your proc 
</ol> 


<p>Sometimes an ActAVItY may nee 
independently of the activity li 
application that allows you to u 
may take a long time, and the ap 
the application will it is execu 
should start a {@link Service} i 
the system to properly prioritiz 


= n ee oe i L 一 一 a d ee naa < 一 == 


AR ARREA RA 


: 效果 与 ECTranslation 基 本 一 致 ， 本 文 仅 用 作 学 习 ， 不 造 轮子 ， 如 果 需 要 使 用 ， 直 接 使 用 
S ° 
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二 、 准 备 工作 
首先 需要 安装 IntelliJ IDEA 

下 载 网 址 : https:W/www.jetbrains.comVideaV 
下 载 好 就 可 以 了 ~~ 


然后 安装 ， 运 行 ， 点 击 create New Project: 


CaJava 


Ez Java FX 
a Additional Libraries and Frameworks: 
‘ig: Android 


ò IntelliJ Platform Plugin | © Groovy 


m Maven 
© Gradle 


New Project 


Ez IntelliJ IDEA Community Edition IC- 145.972.3 (java version "1.8.0_91") 





© Groovy 
© Griffon 


E Kotlin 


Ez Empty Project 


[No library selected] S Create... 


Error: library is not specified 
按照 上 图 进行 选择 ， 如 果 没 有 SDK， 则 点 击 New 新 建 一 个 即 可 。 
然后 点 击 Next, 输 入 项 目 名 称 选择 位 置 ， 就 可 以 点 击 finish 了 。 


项 目的 结构 如 下 : 


插件 开发 





© 9 © 
& intelliJ_IDE ) È src ) 
B Project =v © +|% l- 


v #intelliJ_IDE ~/develop_work/intelliJ_IDE 
> B .idea 
> Clout 
y ESresources 
v © META-INF 
& plugin.xml 
= src 
[a intelli_IDE.iml 
> External Libraries 





Src 目 录 下 主要 用 于 存放 我 们 编写 的 代码 。 
这 样 准备 工作 就 结束 了 ~~ 
三 、 编 码 


(1) 关键 知识 


编码 实际 上 核心 的 一 个 类 叫做 AnAction， 可 以 直接 选择 NEW->Action， 如 下 图 : 
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ooo Tv， 


& intelliJ_IDE ) F src ) Ej com ) [R Kotlin File/Class 


% Cut 38X 
j z (©) Groovy Class 
Æ Project | m Copy 3C B Fil vy 
& intelliJ_IDE ~/develop_wd Copy Path 全 3EC ile 
” D.idea ; E Package 
© copyright ory eer alien li) package-info.java 
Bo Eh f Copy Reference XTEC : 
in Paste v | E HTML File 
E .name 
i fi) JavaFXApplication any. com’ 
alas Find Usages EG 加 人 
iow oe Find in Path... AH 


Eè modules.xml 


图 workspace.xml Replace in Path... 
Ez resources Analyze > Edit File Templates... 


E1 META-INF 


È XSLT Stylesheet 


Refactor > GUI Form 
Dialog 






Add to Favorites 





| Form Snapshot 
[à Resource Bundle 


_Elcom.zhy.test Show Image Thumbnails 





ih External Libraries Reformat Code OHF Application Component 5/gettiı 
Optimize Imports Project Component 
Delete... [> Module Component 5 
Make Module ‘intelliJ_IDE' Baan n 
Compile 'com.zhy.test' THFO | 


> Run ‘Tests in 'com.zhy.test" RE 本 
& Debug ‘Tests in 'com.zhy.test" SND a z 
BS Run 'Tests in 'com.zhy.test" with Coverage 


© Create 'Tests in 'com.zhy.test"... 


Local History > 
(5 Synchronize 'test' 


Reveal in Finder 


然后 填写 一 些 相关 信息 : 


qu 


New Action 


Action ID: TestTranslation.TranslateAction 


Class Name:  TranslateAction 
Name: Translate 


Description: | translate for selected word 





Add to Group 


Groups: Actions: Anchor: 
Dvcs.Log.ContextMenu () $Undo (Undo) © First 


Dvcs.Log.Toolbar () | $Redo (Redo) 





Last 
EditAndWatch (Edit and Watch) CutCopyPasteGroup (Cut/Copy/Paste Actions) = 
EditBookmarksGroup (Bookmarks) EditCreateDeleteGroup (Editor Create/Delete Actions) Before 
reateDeleteGroup (Editor Create/Delete Actions) FindMenuGroup (Find) Af 
ter 






Macros (Macros) 


EditMenu (Edit) 
` EditorToggleColumnMode (Column Selection Mode) 


ditor Select Actions) 





=e, EditSelectGroup (Editor Select Actions) 


Keyboard Shortcuts 





First: | Ed) | 





x x 


Second: 


他 Cancel Cok | 
需要 十 写 的 属性 如 下 : 


ActionID: 代 表 该 Action 的 唯一 的 ID， 一 般 的 格式 为 : pluginName.ID ClassName: 类 名 Name: 
就 是 最 终 插件 在 菜单 上 的 名 称 Description: 对 这 个 Action 的 描述 信息 


小 、 
y 


然后 往 下 ， 选 择 这 个 Action 即 将 存在 的 位 置 


我 们 选择 的 是 EditMenu， 右 侧 选 择 为 first， 即 EditMenu 下 的 第 一 个 ， 效 果 如 图 : 


id Studio File | Edit | View Navigate Code Analyze Refac 


| Translate ^l tp-utils -| 
xa Gg > ğ 
AN m zhy ) M andı irces > 的 
v % Cut dX java x 
tp-utils (~/githt 加 Copy C | KNOW 
radle Copy Path THC </ol 
lea Copy as Plain Text 
lild Copy Reference X THC 
AM nenia aD <n >S 


RE FREME 快捷 键 了 ~~ 
都 填写 完成 就 可 以 点 击 OK 了 。 
点 击 ok 之 后 ， 可 以 看 到 为 我 们 生成 了 下 类 : 


public class TranslateAction extends AnAction { 
@Override 

public void actionPerformed(AnActionEvent e) { 
// TODO: insert action logic here 

} 


} 


此 外 我 们 刚才 填写 的 信息 ， 也 在 plugin.xml 中 完成 了 注册 ， 大 家 可 以 进去 看 一 眼 ，actions 的 标 
签 中 ， 


当 我 们 点 击 菜单 的 时 候 ， 就 回 触 发 actionperformed() 方法 。 
那么 这 么 看 ， 我 们 在 这 个 方法 中 只 要 完成 三 件 事 : 
获得 当前 选中 的 单词 调用 相关 API 得 到 单词 的 意思 通过 一 个 类 似 于 PopupWindow 来 显 


当然 ， 为 了 尽快 的 测试 ， 你 可 以 先 在 里 面 弹 一 个 对 话 框 ， 例 如 如 下 : 


public void actionPerformed(AnActionEvent event) { 


Messages. showMessageDialog("Hello World !", "Information", Messages.getInformationIcon 


()); 


} 


预期 效果 是 点 击 Tranlate 菜 单 ， 或 者 按 快 捷 键 会 弹出 一 个 提示 对 话 框 。 


那么 点 击 Run: 


~ z i | 7) wj JeW H J“ eW: iwwserv 


Ye Plugin K 


然后 它 会 默认 局 动 一 个 新 的 IntelliJ IDEA 的 界面 ， 你 可 以 随便 新 建 一 个 项 目 ， 
发 现 Edit 下 多 了 一 个 Translate 菜 单 ， 点 击 即 可 弹出 我 们 设 定 的 对 话 框 : 


Information 
4 KA Hello World 
ne > 
"Tj 
on 
am 
xt 


ok， 测 试 通 过 就 放心 了 ~ 


= 


获得 当前 选中 的 单词 调用 相关 API 得 到 单词 的 意思 通过 一 个 类 似 于 PopupWindow 来 显示 


剩 下 的 就 是 功能 性 的 API 了 ~ 


(2) 获得 当前 选中 的 单词 


@Override 
public void actionPerformed(AnActionEvent e) { 
// TODO: insert action logic here 
final Editor mEditor = e.getData(PlatformDataKkeys.EDITOR) ; 
if (null == mEditor) { 
return; 
} 
SelectionModel model = mEditor.getSelectionModel(); 
final String selectedText = model.getSelectedText(); 
if (TextUtils.isEmpty(selectedText)) { 
return; 
} 
} 
是 不 是 觉得 API 很 陌生 ， 轧 ， 我 也 觉得 很 陌生 ， 关 于 API 这 里 介绍 其 实 没什么 意义 ， 本 文 主要 


目的 是 让 大 家 对 自 定义 插件 有 个 类 helloworld 的 认识 ， 至 于 插件 里 面 的 代码 涉及 到 的 API| 等 到 
大 家 需要 编写 插件 的 时 候 ， 再 详细 学 习 就 好 了 ， 现 在 就 不 要 浪费 精力 记忆 这 些 东 西 了 。 


上 面 的 代码 就 是 获得 选中 的 文本 ， 通 过 一 个 Editor， 然 后 拿 到 SelectionModel， 再 拿 到 
selectedText， 从 字面 上 还 是 变 好 理解 的 。 


拿 到 选中 的 文本 之 后 ， 应 该 就 是 去 查询 该 单词 的 意思 了 ， 查 询 呢 ，ECTranslation 用 的 是 

youdao 的 Open SDK， 其 实 也 很 简单 ， 就 是 拼接 一 个 ur|， 然 后 等 着 解析 返回 数据 就 好 了 。 
(3) 调用 相关 API 得 到 单词 的 意思 

有 道 API 的 地 址 : 

http:VVfanyi.youdao.comvVopenapi?path=data-mode 

大 家 如 果 想 要 做 单词 翻译 ， 可 以 看 下 ， 非 常 简单 。 


涉及 到 的 代码 : 


String baseUrl = "http://fanyi.youdao.com/openapi.do?keyfrom=Skykai521&key=977124034&t 
ype=data&doctype=json&version=1.1&q="; 


HttpUtils.doGetAsyn(baseUrl + selectedText, new HttpUtils.CallBack() { 
public void onRequestComplete(String result) { 

Translation translation = gson.fromJson(result, Translation.class); 
showPopupBalloon(mEditor, translation.toString()); 

} 


3); 


DUS eas 贴 了 ， 就 是 直接 开 了 个 线程 ， 通 过 HttpUrlConnection 去 访问 网 络 ， 大 家 的 项 目 中 
或 者 通过 搜索 引擎 ， 代 码 一 搜 一 堆 。 


baseUrl 就 是 有 道 的 url > as 中 的 单词 就 是 完整 的 ur 了， 然后 通过 http 访 问 ，callback 
回调 出 返回 的 字符 串 ， 返回 的 是 json 类 型 的 字符 串 。 


baseUri 是 : 


http:VVfanyi.youdao.comVopenapi.do? 
keyfrom=Skykai521&key=977124034&type=data&doctype=json&version=1.1&q=name 


我 们 根据 返回 的 json 字 符 串 生成 了 一 个 类 Translation ; 
然后 通过 Gson 转 化 为 Translation 对 象 。 


ps: 拿 着 上 面 的 baseUrl 后 面 跟 一 个 任何 单词 ， 直 接 访问 浏览 器 就 能 看 到 返回 的 json 数 据 了 ， 这 
里 大 家 天 天 写 接口 ， 类 似 的 步骤 比 我 肯定 还 熟悉 。 


好 了 ， 有 了 返回 的 数据 以 后 ， 直 接 通过 一 个 类 似 popupWindow 展 现 即 可 。 


(4) 通过 一 个 类 似 于 PopupWindow 来 显示 


涉及 到 的 代码 : 


private void showPopupBalloon(final Editor editor, final String result) { 
ApplicationManager.getApplication().invokeLater(new Runnable() { 

public void run() { 

JBPopupFactory factory = JBPopupFactory.getInstance(); 


factory.createHtmlTextBalloonBuilder(result, null, new JBColor(new Color(186, 238, 186 
), new Color(73, 117, 73)), null) 


. setFadeoutTime( 5000) 
.createBalloon() 


. show(factory.guessBestPopupLocation(editor), Balloon.Position.below) ; 


3); 


这 个 APl， 思 ， 我 copy 的 源码 ， 依 然 是 不 求 记 住 ， 知 道 这 有 个 类 似 的 功能 即 可 。 


简单 看 一 下 ， 是 通过 创建 一 个 JBPopupFactory， 然 后 通过 它 创建 一 个 
HtmlTextBalloonBuilder ， 通 过 这 个 builder 去 设置 各 种 参数 ， 最 后 show e 


ok， 对 于 一 个 入 门 的 例子 ， 不 要 太 强求 对 插件 中 这 些 API 的 掌握 ， 还 是 那 句 话 ， 等 需要 写 了 再 
去 查 ， 需 要 什么 功能 ， 哪 怕 到 对 应 的 插件 中 去 copy 源 码 都 可 以 ， 当 然 也 有 文档 : 


http: VVwww.jetbrains.orgVintellijVsdkVdocsVtutorials.html 


有 兴趣 的 可 以 整理 各 种 类 型 的 播 件 ， 比 如 弹出 popupWindow， 生 成 代码 ， 生 成 文件 类 别 的 ， 
然后 对 相关 的 API 进 行 收集 与 整理 。 


这 样 代 码 写 完了 ， 先 测试 一 下 ， 点 击 RUN ， 然 后 看 效果 ~ 
我 们 这 里 肯定 是 测试 没 问 题 的 ， 效 果 图 就 是 开始 的 那个 gif. 
p 果 没有 问题 ， 就 可 以 去 部 署 和 发 布 我 们 的 插件 给 别人 去 使 用 了 。 


两 部 也 非常 简单 。 


`、 部 着 插件 


(1) 填写 插件 相关 信息 


打开 项 目 文件 的 plugin.xml， 如 下 图 : 


GS intellij_IDE ) Pa resources ) [=] META-INF ) 6% plugin.xml ) 









E Project © = | Ææ- I+) & plugin.xml x 
# intelliJ_IDE ~/develop_work/intelliJ_IDE | idea-plugin | 
B idea 二 
> Dout <id>com. zhy. test.plugin. Trans late</id> 
PS resources <name>Trans late Now</name> 
EETA Qversion>1.0</version> 
| ogma <vendor email="support@yourcompany.com" url="http://www. yolircompany . com">\ 
ce <description><! [CDATA[ 
[X intellij_IDE.iml translate for your selected word. <br> 


ih External Libraries ]]></description> 


<change-notes><! [CDATA[ 


Add change notes here.<br> 
<em>most HTML tags may be used</em> 
]]> 
</change-notes> 


<!— please see http://www. jetbrains.org/intellij/sdk/docs/basics/getting_ 
<idea-version since-build="141.0"/> 


在 里 面 卉 写 id,name,version 等 。。。 记 得 随便 卉 一 下 ~ 


然后 ， 点 击 build->prepare plugin...， 如 下 图 : 


eee = 屏幕 快照 2016-05-30 下 午 9.58.08 
O-palad ô 中 EE 
te Code Analyze Refactor | Build | Run Tools VCS Window Help 全 D 
Œ TranslateAction.java - 42 Make Project $B = 
| Make Module 'intelliJ_IDE' 
Compile 'TranslateAction.java' TEF 


ication.class x (© Translationjava x | 
© Rebuild Project 


ent e) { Generate Ant Build... 


latformDataKeys.EDITOR) ; 





SelectionModel(); 
yetSelectedText(); 


会 在 项 目的 根 目 录 生 成 一 个 jar， 如 图 : 


M /Users/zhy/develop_work/intelliJ_IDE 
mv ey OU J Q 


名 称 入 ”修改 日 期 

> .idea 今天 下 午 10:02 
昨天 下 午 4:43 

= intelliJ_IDE.jar 今天 下 午 10:02 
昨天 下 午 4:51 

> | resources 昨天 下 午 4:43 

> B src 今天 下 午 9:43 


oo 
oo 
= 
O 
= 
[2 
o 





LBS, 





这 个 jar 就 可 以 用 于 安装 了 。 


(2) 安装 插件 


打开 Andorid Studio， 选 择 Preferences -> Plugins -> Install plugin from disk， 选 择 我 们 生成 
的 jar 即 可 ， 如 图 : 


@ Android Studio File Edit View Navigate Code Analyze Refactor Build Run Tools VCS Window Help @ 





OHS +A $F AR SD H(Wsampe-okhp- | > X k EE RPS YR SCRE S ? 






















e@.e Preferences 
IQ ) Plugins 
> Appearance & Behavior (Q ) Show: [All plugins ~ | 
Keymap 


Sort by: name 7 „ignore 


Plugins 












> i x , sete 
Version Control Į Android ButterKnife Zelezny 区 Version: 1.2 
Build, Execution, Deployment 
> Languages & Frameworks a i | 
guag B Android NDK Support 区 .ignore 
> Tools 
F ag i 
> Other Settings a Android Support v GitHub | Issues | Donate ( Pa 
a% i -ignore is a plugin for .gitigm 
= Co pyright v .dockerignore (Docker), .che 
(Bazaar), .boringignore (Dar 
a Coverage 区 /shintignore (SSHing, -tigno. 
fooignore (Floobits) files in ' 
Features 
&® CVS Integration v @ Files syntax highlig 
@ Coloring ignored fil 
ae j i @ Gitignore templates 
i ”EditorConfig 区 ie aca A 
@ Show ignored files 
g @ Create file in currer 
¥ Gauge j @ Generate Gitignore 
@ Add selected file/di 
i Git Integration 区 @ Suggesting .gitignc 
@ Entries inspection ( 
syntax, relative entr 
è& GitHub M @ Comments and bra 
__Install JetBrains plugin... | | Browse repositories... _ Install plugin from disk... _ 











点 击 安装 ， 然 后 重启 即 可 。 


好 了 ， 重 局 完 成 就 可 以 在 EDIT 下 看 到 Translate 菜 单 了 ， 选 中 单词 ， 点 击 菜单 或 者 快捷 键 都 能 
实现 翻译 了 。 


如 果 你 有 兴趣 ， 赶 紧 编 写 一 个 插件 自己 玩 吧 。 
当然 ， 还 可 以 把 我 们 的 插件 发 布 到 仓库 ， 支 持 在 plugin 中 搜索 安装 ， 参 考 : 
http: VVwww.jetbrains.orgVintellij\VsdkVdocsVbasics\/getting_startedVpublishing_plugin.html 


就 是 注册 账号 ， 提 交 jar， 填 写 信息 ， 等 着 审核 就 可 以 了 。 


by 
> BB 


终于 到 了 总 结 的 环节 ， 这 么 长 的 文章 其 实 编写 插件 总 结 起 来 就 几 匈 话 。 
下 载 Intellij IDEA > te IDEA payne A 然后 在 里 面 new Action 以 及 编写 API 点 
击 prepare plugin 生 成 jar， 这 个 jar 就 可 以 用 来 安装 了 。 


恩 ， 就 是 这 么 简单 ， 实 践 起 来 会 比较 麻烦 一 点 ， 等 成 功 以 后 ， 回 过 头 来 总 结 ， 发 现 步骤 其 实 
就 那么 几 个 步骤 ~~ 对 于 实际 的 Action 相 关 的 APl， 等 你 在 编写 相关 插件 的 时 候 ， 参 考 别 的 类 似 
插件 ， 查 看 官方 文档 都 可 以 。 


搜索 菜单 选项 


476 


查找 操作 功能 


附录 快捷 键 


Ctrl 
快捷 键 介绍 

Ctrl + F 在 当前 文件 进行 文本 查找 ( 必 备 ) 

Ctrl+R 在 当前 文件 进行 文本 替换 (LS) 

Ctrl + Z 撤销 〈 必 备 ) 

Ctrl + Y 删除 光标 所 在 行 或 删除 选中 的 行 ( 必 备 ) 

Ctrl + X 剪 切 光 标 所 在 行 或 剪 切 选择 内 容 

Ctrl + C 复制 光标 所 在 行 或 复制 选择 内 

Ctrl + D 复制 光标 所 在 行 或 复制 选 wane: hts 容 插入 光标 位 置 下 面 ( 必 

EY 进 式 选择 代码 块 。 可 选中 光标 所 在 的 单词 或 段落 ， 连 续 按 会 在 原 有 选中 
的 基础 上 再 扩展 选中 范围 (bs) 

Ctrl + E 显示 最 近 打 开 的 文件 记录 列表 

Ctrl + N 根据 输入 的 类 名 查找 类 文件 

Ctrl + G 在 当前 文件 跳 转 到 指定 行 处 

Ctrl + J 插入 自 定义 动态 代码 模板 

Ctrl + P 方法 参数 提示 显示 

ctr+aQ 光标 所 在 的 变量 / 类 名 /方法 名 等 上 面 (也 可 以 在 提示 补充 的 时 候 按 ) > 

显示 文档 内 容 

Ctrl + U 前 往 当 前 光标 所 在 的 方法 的 父 类 的 方法 /接口 定义 

Ctrl + B 进入 光标 所 在 的 方法 /变量 的 接口 或 是 定义 处 ， 等 效 于 Ctrl + 左 键 单 击 

Ctrl + K 版 本 控制 提交 项 目 ， 需 要 此 项 目 有 加 入 到 版 本 控制 才 可 用 

Ctrl + T 版 本 控制 更 新 项 目 ， 需 要 此 项 目 有 加 入 到 版 本 控制 才 可 用 

Ctrl + H 显示 当前 类 的 层次 结构 

Ctrl + O 选择 可 重 写 的 方法 

Ctrl + | 选择 可 继承 的 方法 

Ctrl + + 展开 代码 


Ctrl + - a & RAR 


Ctrl + / 注释 光标 所 在 行 代码 ， 会 根据 当前 不 同文 件 类 型 使 用 不 同 的 注释 符号 (ub 


Ctrl + [ 移动 光标 到 当前 所 在 代码 的 花 括号 开始 位 置 
Ctrl + ] 移动 光标 到 当前 所 在 代码 的 花 括号 结束 位 置 
Ctrl + F1 在 光标 所 在 的 错误 代码 处 显示 错误 信息 
Ctrl + F3 调转 到 所 选中 的 词 的 下 一 个 引用 位 置 
Ctrl + F4 关闭 当前 编辑 文件 

在 Debug 模式 下 ， 设 置 光 标 当前 行为 断 点 ， 如 果 当前 已 经 是 断 点 则 去 掉 
Ctrl + F8 断 点 
Ctrl + F9 执行 Make Project 操作 
Ctrl + F11 选中 文件 /文件 来 ， 使 用 助 记 符 设 定 / 取消 书 签 
Ctrl + F12 弹出 当前 文件 结构 层 ， 可 以 在 弹出 的 层 上 直接 输入 ， 进 行 第 选 
Ctrl + Tab 编辑 窗口 切换 ， 如 果 在 切换 的 过 ee ， 则 是 关闭 对 应 选中 的 
Ctrl + ko Be AN RE A 
Enter ay 能 分 隔行 
Ctrl + End 跳 到 文件 尾 
Ctrl + 跳 到 文件 头 
Home 
Ctrl + 基础 代码 补 全 ， 默 认 在 Windows 系统 上 被 输入 法 占用 ， 需 要 进行 修改 ， 
Space 建议 修改 为 Ctrl + 过 号 ( 必 备 ) 
Cue 删除 光标 后 面 的 单词 或 是 中 文句 
Delete 
Ctrl + 

删除 光标 前 面 的 单词 或 是 中 文句 

BackSpace 
ue 定位 到 对 应 数值 的 书签 位 置 
1,2,3...9 
2 在 打开 的 文件 标题 上 ， 弹 出 该 文件 路 径 
ne 按 Ctrl 不 要 松 开 ， 会 显示 光标 所 在 的 类 信息 摘要 
ae ec 光标 跳 转 到 当前 单词 /中 文句 的 左 侧 开头 位 置 
Aes 光标 跳 转 到 当前 单词 / 中 文句 的 右 侧 开头 位 置 
Ctrl + 前方 


向 刍 等 效 于 鼠标 滚轮 向 前 效果 


Ctrl + 后 方 


向 键 


Alt 


快捷 键 
Alt + ` 
Alt + Q 
Alt + F1 
Alt + F2 
Alt + F3 
Alt + F7 
Alt + F8 
Alt + 


Home 


Alt + 
Enter 


Alt + 
Insert 


Alt + AA 


向 键 


Alt + AA 


向 键 


Alt + 前 方 


向 键 


Alt + 后 方 


向 键 


Alt + 
1,2,3...9 


等 效 于 鼠标 滚轮 向 后 效果 


介绍 
显示 版 本 控制 常用 操作 菜单 弹出 层 
弹出 一 个 提示 ， 显 示 当 前 类 的 声明 /上下文 信 息 
显示 当前 文件 选择 目标 弹出 层 ， 弹 出 层 中 有 很 多 目标 可 以 进行 选择 
对 于 前 面 页 面 ， 显 示 各 类 浏览 器 打开 目标 选择 弹出 层 
选中 文本 ， 和 逐个 往 下 查找 相同 文本 ， 并 高 亮 显 示 


查找 光标 所 在 的 方法 / 变量 / 类 被 调用 的 地 方 
在 Debug 的 状态 下 ， 选 中 对 象 ， 弹 出 可 输入 计算 表达 式 调试 框 ， 查 看 该 输 
入 内 容 的 调试 结果 
定位 /显示 到 当前 文件 的 Navigation Bar 


IntelliJ IDEA 根据 光标 所 在 问题 ， 提 供 快速 修复 选择 ， 光 标 放 在 的 位 置 不 同 
提示 的 结果 也 不 同 (Lg) 


代码 自动 生成 ， 如 生成 对 象 的 set / get 方法 ， 构 造 函 数 ，toString() 等 
按 左 方向 切换 当前 已 打开 的 文件 视图 
按 右 方向 切换 当前 已 打开 的 文件 视图 
当前 光标 跳 转 到 当前 文件 的 前 一 个 方法 名 位 置 
当前 光标 跳 转 到 当前 文件 的 后 一 个 方法 名 位 置 


显示 对 应 数值 的 选项 卡 ， 其 中 1 是 Project 用 得 最 多 


快捷 键 
Shift + F1 
Shift + F2 
Shift + F3 
Shift + F4 
Shift + F6 


Shift + F7 


Shift + F8 

Shift + F9 

Shift + F10 
Shift + F11 

Shift + Tab 
Shift + ESC 
Shift + End 
Shift + Home 
Shift + Enter 
Shift + 左 键 单 击 


Shift + 滚轮 前 后 
滚动 


Ctrl + Alt 


如 果 有 外 部 文档 可 以 连接 外 部 文档 
跳 转 到 上 一 个 高 亮 错 误 或 警告 位 置 
在 查找 模式 下 ， 查 找 匹 配 上 一 个 
对 当前 打开 的 文件 ， 使 用 新 Windows 窗 口 打 开 ， 昌 窗口 保留 
对 文件 /文件 夹 重 命名 


在 Debug 模式 下 ， 智 能 步 入 。 断 点 所 在 行 上 有 多 个 方法 调用 ， 会 弹 
出 进入 哪个 方法 


在 Debug 模式 下 ， 跳 出 ， 表 现 出 来 的 效果 跟 FO 一 样 
等 效 于 点 击 工具 栏 的 Debug 4242 
等 效 于 点 击 工具 栏 的 Run 按钮 
弹出 书签 显示 层 
取消 缩 进 
隐藏 当前 或 最 后 一 个 激活 的 工具 窗口 
选中 光标 到 当前 行 尾 位 置 
选中 光标 到 当前 行头 位 置 
开始 新 一 行 。 光 标 所 在 行 下 空 出 一 行 ， 光 标定 位 到 新 行 位 置 

在 打开 的 文件 名 上 按 此 快捷 键 ， 可 以 关闭 当前 打开 文件 


当前 文件 的 横向 滚动 轴 深 动 


快捷 键 
Ctrl + Alt + 上 
Ctrl + Alt + O 
Ctrl + Alt + | 
Ctrl + Alt + T 
Ctrl + Alt + J 
Ctrl + Alt + H 
Ctrl + Alt + B 
Ctrl + Alt + V 
Ctrl + Alt + Y 
Ctrl + Alt + S 


Ctrl + Alt + F7 


Ctrl + Alt + F11 
Ctrl + Alt + Enter 
Ctrl + Alt + Home 


Ctrl + Alt + 
Space 


Ctrl + Alt + £ 
向 键 


Ctrl + Alt + GA 
向 键 


Ctrl + Alt + 前 方 
向 键 


Ctrl + Alt + 后 方 
向 键 


Ctrl + Shift 


快捷 键 


Ctrl + Shift + 
F 


Ctrl + Shift + 
R 


Ctrl + Shift + 


介绍 
格式 化 代码 ， 可 以 对 当前 文件 和 整个 包 目 录 使 用 (LS) 
优化 导入 的 类 ， 可 以 对 当前 文件 和 整个 包 目 录 使 用 (Lg) 
光标 所 在 行 或 选中 部 分 进行 自动 代码 缩 进 ， 有 点 类 似 格 式 化 
对 选中 的 代码 弹出 环绕 选项 弹出 层 
弹出 模板 选择 窗口 ， 将 选 定 的 代码 加 入 动态 模板 中 
调用 层次 
在 某 个 调用 的 方法 名 上 使 用 会 跳 到 具体 的 实现 处 ， 可 以 跳 过 接口 
快速 引进 变量 
同步 、 刷 新 
打开 IntelliJ IDEA 系统 设置 


显示 使 用 的 地 方 。 寻 找 被 该 类 或 是 变量 被 调用 的 地 方 ， 用 弹出 框 的 


方式 找 出 来 
切换 全 屏 模 式 
光标 所 在 行 上 空 出 一 行 ， 光 标定 位 到 新 行 
弹出 跟 当 前 文件 有 关联 的 文件 弹出 层 


类 名 自动 完成 


退回 到 上 一 个 操作 的 地 方 ( 必 备 ) 


前 进 到 上 一 个 操作 的 地 方 ( 必 备 ) 


在 查找 模式 下 ， 跳 到 上 个 查找 的 文件 


在 查找 模式 下 ， 跳 到 下 个 查找 的 文件 


介绍 


根据 输入 内 容 查找 整个 项 目 或 指定 目录 内 文件 (Lg) 


根据 输入 内 容 替 换 对 应 内 容 ， 范 围 为 整个 项 目 或 指定 目录 内 文件 ( 必 


备 ) 


Ctrl + Shift + 
Z 


Ctrl + Shift + 
W 


Ctrl + Shift + 
N 


Ctrl + Shift + 
U 


Ctrl + Shift + 
T 


Ctrl + Shift + 
C 


Ctrl + Shift + 
V 


Ctrl + Shift + 
E 


Ctrl + Shift + 
H 


Ctrl + Shift + 
B 


Ctrl + Shift + 
| 


Ctrl + Shift + 
A 


Ctrl + Shift + 
/ 


Ctrl + Shift + 
[ 


Ctrl + Shift + 
] 


Ctrl + Shift + 


+ 


Ctrl + Shift + 


Ctrl + Shift + 
F7 


Ctrl + Shift + 
F8 


自动 将 下 一 行 合并 到 当前 行 末 尾 ( 必 备 ) 


取消 撤销 ( 必 备 ) 


递 进 式 取消 选择 代码 块 。 可 选中 光标 所 在 的 单词 或 段落 ， 连 续 按 会 在 原 


有 选中 的 基础 上 再 扩展 取消 选中 范围 ( 必 备 ) 


通过 文件 名 定位 / 打开 文件 / 目录 ， 打 开 目 录 需 要 在 输入 的 内 容 后 面 多 


加 一 个 正 斜 杠 ( 必 备 ) 


对 当前 类 生成 单元 测试 类 ， 如 果 已 经 存在 的 单元 测试 类 则 可 以 进行 选择 


复制 当前 文件 磁盘 路 径 到 剪贴 板 


弹出 绥 存 的 最 近 搁 贝 的 内 容 管理 器 弹出 导 


显示 最 近 修 改 的 文件 列表 的 弹出 层 


显示 方法 层次 结构 


跳 转 到 类 型 声明 处 


快速 查看 光标 所 在 的 方法 或 类 的 定义 


查找 动作 /设置 


代码 块 注释 ( 必 备 ) 


选中 从 光标 所 在 位 置 到 它 的 顶部 中 括号 位 置 


选中 从 光标 所 在 位 置 到 它 的 底部 中 括号 位 置 


展开 所 有 代码 


dr dt PR A KAR 


亮 显示 所 有 该 选中 文本 ， 按 Esc 高 亮 消失 


I 


在 Debug 模式 下 ， 指 定 断 点 进入 条 件 


Ctrl + Shift + 
FQ 


Ctrl + Shift + 
F12 


Ctrl + Shift + 
Space 


Ctrl + Shift + 
Enter 


Ctrl + Shift + 
Backspace 


Ctrl + Shift + 
125329 


Ctrl + Shift + 
左 键 单 击 


Ctrl + Shift + 
左 方向 键 


Ctrl + Shift + 
右 方向 键 


Ctrl + Shift + 
左 方向 键 


Ctrl + Shift + 
右 方向 键 


Ctrl + Shift + 
前 方向 键 


Ctrl + Shift + 
后 方向 键 


Alt + Shift 


编译 选中 的 文件 / 包 / Module 


自动 结束 代码 ， 行 末 自 动 添加 分 号 (bs) 


退回 到 上 次 修改 的 地 方 


快速 添加 指定 数值 的 书签 


把 光标 放 在 某 个 类 变量 上 ， 按 此 快捷 键 可 以 直接 定位 到 该 类 中 ( 必 备 ) 
在 代码 文件 上 ， 光 标 跳 转 到 当前 单词 /中 文句 的 左 侧 开头 位 置 ， 同 时 选 
中 该 单词 /中 文句 
在 代码 文件 上 ， 光 标 跳 转 到 当前 单词 / 中 文句 的 右 侧 开头 位 置 ， 同 时 选 
中 该 单词 /中 文句 
在 光标 焦点 是 在 工具 选项 卡 上 ， 缩 小 选项 卡 区 域 
在 光标 焦点 是 在 工具 选项 卡 上 ， 扩 大 选项 卡 区 域 


光标 放 在 方法 名 上 ， 将 方法 移动 到 上 一 个 方法 前 面 ， 调 整 方法 排序 


光标 放 在 方法 名 上 ， 将 方法 移动 到 下 一 个 方法 前 面 ， 调 整 方法 排序 


快捷 键 


Alt + Shift + 
N 


Alt + Shift + 
F 


Alt + Shift + 
C 


Alt + Shift + 
| 


Alt + Shift + 
F7 


Alt + Shift + 
F9 


Alt + Shift + 
F10 


Alt + Shift + 
左 键 双击 


Alt + Shift + 
前 方向 键 


Alt + Shift + 
后 方向 键 


显示 添加 到 收藏 夹 弹 出 层 / 添加 到 收藏 夹 


查看 最 近 操 作 项 目的 变化 情况 列表 


查看 项 目 当前 文件 


在 Debug 模式 下 ， 下 一 步 ， 进 入 当前 方法 体内 ， 如 果 方 法 体 还 有 方法 ， 
则 会 进入 该 内 葡 的 方法 中 ， 依 此 循环 进入 


弹出 Debug 的 可 选择 菜单 


弹出 Run 的 可 选择 菜单 


选择 被 双击 的 单词 /中 文句 ， 按 住 不 放 ， 可 以 同时 选择 其 他 单词 / 中 文句 


移动 光标 所 在 行 向 上 移动 


移动 光标 所 在 行 向 下 移动 


Ctrl + Shift + Alt 


Ctrl + Shift + Alt + V 
Ctrl + Shift + Alt + N 
Ctrl + Shift + Alt + S 
Ctrl + Shift + Alt + C 


其 他 


快捷 键 介绍 
KS HK Fb NE 

前 往 指 定 的 变量 / 方法 

打开 当前 项 目 设置 
复制 参考 信息 


快捷 
键 


F2 
F3 
F4 


F7 


F8 


F9 


F11 
F12 
Tab 
ESC 
连 按 


两 次 
Shift 


介绍 


跳 转 到 下 一 个 高 亮 错 误 或 警告 位 置 (Lg) 
在 查找 模式 下 ， 定 位 到 下 一 个 匹配 处 
编辑 源 


在 Debug 模式 下 ， 进 入 下 一 步 ， 如果 当 前 行 断 点 是 一 个 方法 ， 则 进入 当前 方法 
体内 ， 如 果 该 方法 体 还 有 方法 ， 则 不 会 进入 该 内 骨 的 方法 中 


在 Debug 模式 下 ， 进 入 下 一 步 ， 如 果 当 前 行 断 点 是 一 个 方法 ， 则 不 进入 当前 方 
法 体内 


在 Debug 模式 下 ， 恢 复 程序 运行 ， 但 是 如 果 该 断 点 下 面 代 码 还 有 断 点 则 停 在 下 
一 个 断 点 上 


添加 书签 
回 到 前 一 个 工具 窗口 
缩 进 


从 工具 窗口 进入 代码 文件 窗口 


弹出 Search Everywhere 弹出 层 


